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I i-t± rod Ljc^ion 

This booK has b«en written both ai a gBrvral purpocB VIC 29 
ATvl 6592 microprDcessDr tutoriAl and ac a cperific co(npl#inerrt to ind 
Quid* for th* u5e at a 5tt o# software tools. Ths toolHi ilmg with 
thi« bixiMcDnipriw Develop-20r i product of French Silk. While this 
book is cfrldirnly useful by itsei-F, iis valut may b« magnifiBd 
consiQerAblv when uasd :n conjunctiDn with the Dther toois. The five 
■aaftware tools ar* Th* Assembltr, The Editor, The Loader. The HonitDr 
WA "mi^ Decoder. Qach of the tools is described in detail in the 
MCDTid section of this text. Caiie-tte tape la the Lkaual dis-tribution 
media for the tools. However, a disk version is also a^tiUble 4S is 
in iMttnflid tfa-tJTt verfilon. Included in the bick of Ihii booU a in 
ejtchange offer -lor those who wish to^^radp their toolkit. 

This booK is designed to latii-fy ttie needs Df prograrniners of 

sevEral Itvi-li of ejtpsrienwi indudlna the very inenperienced. It ii 
Kvritten in three sections. 

The fir^t section gives a detailed look at tbe architirture of 
the 6Sfr! iTritrEipmessor. Iti idEJreBsing niodttf rtgicter set truA 
instruction set ara Bvantinad. The nati^re arid structire of diia is 
alsD p>rplor«d. The introduction to asse mbly languacie is preEentBd in 
this sertion. 

The second section is directed at providing informatiorr on the 
im Of the GoftwirE toolE which ara in integral par-t of this puKaQt. 
It wilt bring you step by step through thp mectidnics of creating, 
modifying, running and debuggirkg your prngrams- 

The third saclion is ver^ VIC-5peci*ic. It providet th» 
informitlDn which is necessary to utilize the VIC'e built-in prograinS' 
It provides memory maps of all of the VIC's BASIC operating sy-itein 
along with the inf ormatian « to how to um aome of the biiiltHn 
programs. It will tell you how to build custom characters end how to 
maKe auto-start cartridges and to prograiri for game paddlesi joysticks^ 
bit-imtge graphics and to in«Ke ^ound efftcts. The appendixes CLjniein 
additional information on the &5A2 and the VIC along with soine useful 
tables and sample programs. 

None of the programs in the DevBlop-2ft Wit are protVCtPdt 
50 you may mate copies for your Dirfn use. Trrformation is provided in 
Chipltr 6 on niMngbitiCupfCi^Sdf the software tools. You are 
encouraged to do this as soon as possible so as to identify any 
problens with the naflnetic media within the thirty day warranty 
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period. With the E>L»ptlDn ofThe Ludprt yau da not hav« our 
pBrmiseton 1d remove 1ht copyright natice from ihe copies or tft* 
di^Qihdl. H is specifically proKibit&d io m^ike copies ^ resale or 
4or disiribirtion -Ed frisrxlsp r#l*iiv«i AS»>cidles op inyont rise. W« 
hGpE yon wiIlraspectttielegal4nd*-thicaIreBtnctiQrB which apply 
tc the tfie-fl 0* wjflwipe, both ours *nd evflrymw el«'5. While thit 
product provide-s toolfl which m^V* such unscpufujlfliie activitiss vasivr 
to accomplish, it it rmt the jnte-nt o-f Frsnch Silf th»1 you use thsse 
teds for this lie«. Ue appoK and Li^ish To very strongly di9CE)u<ig0 
thflpinting of software, W* would iiso like to point out that there 
are severe penalties aseaciated wilh copyright violation inciudiria 

finrs uptoliflrfflft and impriBonnenl nl up to ore year rot to mention 

civil liability. In the interest of promatlrg the CDnHnued 
development oi high-cujality arwJ low-cosl scrftwars (he conttimpr mijat 
play his 4nd her roLes jti helping flinLmaip this aourc? of revenue 
iofit to the software flevelaf>er. And, is a -final afflument, you, the 
owner oi thia kit are now & member of the coimnunity of software 
developers. It is in all Dur intere^t^ to help d:5G0ii'age the 
continued growth of this problem. Thank you. 

Many people em^uire a« to the origin of the name French Silk. 
There are several roots. The very *irst machine known to have been 

invented or plinet Earth with tho ability to contain i fttored and 
modifiable program to control its operation was invented in 1391 by 
the French silk weaver- Joseph-Marie Charles Jaccjuird. It was known 
as the Jftcquard loom and H^ progrdm? Mrre eriroded as a urtes af 
pirrched holes on paper card Si the dominant means of progrem storage 
^ ihe cwKt 178 years. Thi invention enabled tbp creation of 
beautiful and jntrJcftte patterns jn the finest fabric UTOwn to man and 
was the precursor of tfie modern computer. The fina.lp forcing factor 
in the selection e)4 the namv was the combiriation of the founder'^ 
surneme and his descindency from d line of silk weavErs* (The 
coincidental p^iatence of a deliciota and rich copfic-lion by the sane 
name had reaJly vtry little to da with iD. 



The author ivouJd liHe to e-press thanks to Jim Butterfield and 
Tom Carl for their hfflpful suggestion* and criticisms of the ^arly 
vtrsions of ^ii -tsxt. 
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"TH* 6502 — ^ TDm.±m. ProcHson 



Ac thia Kit in ioojud on the diwlapmKrt of loffwart through 
ttw o^atlvi uH oi machine languagei it will be necessary to first 
(jiderstandi the machine before learning ita larvguage. 

You'rt proDaOly awar« that thAr» is aamthing inaidt thi UM 
of iht VlC-Zfl which ;« Known ts the 45fl2 microprocessor. This is the 
heirtof the VIC, It is also the heart of the Apple, theAtaript^e 
PBTt KlHi AlMt EYHi 05L and a ff w other microconputri^. It is i 
product of K (35 Technology, a vrfwUy owned (Rjbsidiary of ConmodorB 
Business Hichines. 

The £!t2 li tn integrateif arcuit. That isr it Ie a aingle 
Ehlp nf silicon wftlch t\« built Into iXt wrt of like fltchBd ontn iti 
the ■lectT'onic circuitry which connects thousands of micmcopically 
small electronic components. These components an depauted on the 
silicon by some marvel of modefn technology which is beyond the scope 
of Ihis teit4. Ue van'i go into how the eleciponics are Ereated or Kow 
they function electrorduLly. We are interested hen in how to use 
thi« machine and how it fits into the environmBnt of the VIC-28 
ptrtonal computtrj 

Tfie piece of silicon called the £542 is packaged in a piece of 
plastic or nranic material about one inch by two inches. It has U 
little tjug-lihe legi called pirn which connrct the internal circuitry 
to the outside world. These pins plug into a circuit board which has 
other sinilar appearing chips of lilicon, each with its own set of 
pins and its own internal characteristics^ different from the 
characterifltic* of 4ie d5t2. Each of the chips has :ts own specific 
functiDn and tagather thty are urnbimdi through thiir ronntcbng pina 
and the circuit etched on the printea circuit boarb into w^uch they 
4^ plugged, to make a microcoirputer. 

Thit will become morv and more clear ai we E^icribe wha1 each 
of the component chips are for and how they work and how they 
coiemunicale with one another. The description of the functional 
characterifttica of the d5S2 will completely define the procaEEor from 
«w programmer's standpoint. The electrical or electronic 
characteristics are of no interest to us as we have no need to 
unilenlanij the jnachine at that le^l, 

The 6?t2 is a data processor. It is a machine which performs 
siDpU Dp^rations of data manipulation Lnder the control of a stored 
progrBH. BqI^ the data and tin program are stored m nenor^ divices 
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which arp mipgraied circuits eleetncaJW tcnriectefl tc Ihe 6562. 
Progi-am¥ jre a speciaUlas? Of Dd^i infl we witl e^plitn programs 
a+ter vf^ flisciiss data in i mare general senge, 

Dati 15 in+Drmaiipn. It ■:in be the baUntp ot your checking 
flCtDun-t or the grad* your physics teacher gave ygy or the |JD5[lJori of 
PAC-WAN on your vtOeo screen, Jn-forrTraiion, as it is slored in-side- the 
coippuler's (nemor^ Oei/icee ie coBed by a specia] 5ei □* tmple rules, 
Hemory devicei are composed c-F thousands of csIIe, or storage 
iDCJtionSn where the caTa is kept. Each cell is campciEed of e-ight 
EViJilche^ *hich can te turned pdhtr on or off. When the letisr "A" is 
pressed on th& Heybnar-d of your VIC] same elpctrDnic circuitry wjill 
aiftomaticaily cr^ale a pattern of eight switch settings svhich is 
uniquelj identified as the pattern -For ihp Letter '■A\ This is thP 
code for"A". Every character has Its owe code ar>d it IS different 
from ill the other chardcter's codes. There are only ^56 different 
unique codes *hich can be cori5tructed frpnv eight s^vitch settings, 
There are therefore only Z5d possible dif-ferent characters which can 
be repr^PwntPfl and stored in the memMy chips o* the VIC, That's 
suflicienl to handle A-Z, #-9, all the special characters and the 
graphics characters. 

These sw/itches are usually tilled "bitt". Bit « short for 
binary digit. A digit may have Ld possible values, fl-9. A bit may 
have two possible values, *-|. A bit which is turned on may be 
thought of 45 having the vaiup of I anfl if it i§ off, :t is a 9. So 
characters are represented as a string of eight bits with hit values 
of either e or ]. The actual bit string fdr the letter "A" is 
Sieeeflei. The coding scheme J5Ed is dn intern it jonal s tan rl ird ci lied 
ASCTT, which stands for Amencar» Standaird Code far Inforifiaticn 
[nterchari^e. 

The 65*2 's data link with the mcmciry devices "¥ taJLefl the dat4 
bus. This 15 nothing more than a set of eight lines, or electrical 
connections, between the meinary chips and tha i5ft2. Isftien the iS^2, 
u-kder ccmtrol of a progranii wishes to either transfer data to or from 
a memory device, it sencJs an electrical signal on the R/W 'Read/Write) 
linpp telSing the device which direction the datJ i? !□ go. Since the 
■memory device can store thouiands o* characters of datai it is 
necessary for t^e 6^92 to tell it which storage location it wishes to 
get data trgm cr send it to. It does this through another set of 
plec^ricil connections called t^e address bus. Every storage cell 
within the memcry device has a unique address asscciaied with it and 
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when the signal comes to do a data transftrp tht miiFhCiry device is 
designvij to use the inforEn±tiDn aent on the aCdrese bus to Kmjv vfhizh 
ceLl is beirig selected- Each data cell hol6s eight bits of 
information. This basic unit of data^ called a byte, is transferred 
all at onfp aJgng the tighi parallel elett^ifal 4:ctfV»ctjorts Iflipwn 
collectively as the data bus* 

The address bus is very similar Is the dita b js ei<cepi it his 
si>Llepn parallel electrical connectors. Like the data bud the address 
bus iitformalion i* coded in binary. That is, *ach of the smtpen 
lirws may haue only one oi tiwo possible states, a or & ], pre^nted 
to the devices as 9 or +5 volts. The buses are connected directly to 
the pirks wtiich go inside the ^astic package and connect to the 
internal micrctirtuilry on the silicon chips. The siJ<teenb]1 address 
bus allows ior 655^6 different addressaOle memory locations '''here data 
may be stored. 

Fijiillyi there is a control bus which contains lines whi-ch 
help to control the various chi(>a in the VIC. TTie R/W line Jitentioned 
above is one of the control signals. Uith the e>rcBpfion of the 
interrupt lines^ distussed laterj we don't need to know miKti abnut the 
control bus. 

BeifAuu th^ £542 tran^fe^f^ tiy\ pnv»««i4ddt4 ti^M bit^ at a 
time, it is Known as an eight bit parallel processor- "Hie neKt chapter 
will go into more detail on the format of the data as it is stored in 
the ineinory devices. 

Memory devices come in two basic varieties as of thi^ writing, 
FOH is read-only memory. When the power ts turrted off ROH dciesn't 
iosB Its conterts. ROH is a kind of chip which incty be "Read" bjt 
not written to. Its contents are "bumed-in'* at the factory. There 
is a siiniiar kind ot memory device called a PROM which stands for 
Programmable F?OM and it may be modified by a spei^ift), piece of hirQware 
calked a PPOH programmer. It must be erasecj by shining an intense 
ultraviolet light on its top scrface for some preserved length of 
lime. 

Both of these differ ttotp the other main kind of memory device 
which is called RAK. RAH n badly niBnamad. 11 ehouia ba ulL^d HOM 
for MCWifyabla Hemory or RAW fotf- Read And Write. RAH standi for 
Random Access Hemoryp which means you can extract data froiii it in any 
spquencp yoj wint. The same thin^ is tnja of all currently available 
types of memoryp including ROH. 

Anyway* the differences between RAH and ROM is that a program 
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can write to BAM and change ila contents and when the pcwer is turned 
oH thE [cintents of RAM b^a 1»1, whereas ROM cannot be modi-fied by 
ary prrjgrain under any circum ^atancfiE and wT^en the powfi-r is turned c^li 
thB canterrts of ROM are hept intact, in the VIC, all ot the operating 
eyetflm programs and the BASIC irteiTDrplep ar* in RDM. That is why you- 
can run BA&IC ppugradis as snon as you tiim the lEiAchirte an, withciut 
having to load inything +roi'i tape dt nJisK. 



JrnidvThiVIC 



Pafit 2-1 



Bits. Binary digits. Its actually a contradiction jn terms.. 
Binary meAns it C4n have t^s■D possible values. Digit impL^s im, 

Th« bit is tne irtoEt baEir Linit of inforrndticm. It U the 

foundation of ill other morv ca(np)e]< iriformaticn formats. II la the 
only kind of irrfarmatian which nay be stored in a "digital" computer. 
A bit may have the vaIue of tiXhtr ont or i^ro, A byte as a grouping 
ot eight bits. The 65flZ tscaU&d an&ight-bit microprocessor. This 
is because ^t processes end ttores data eight bits at a time. It is 
■nnre cgnvienjent for the piJTpose Of undsrstinfling the nature o* 
contputer data to brea^f the eight bits into two four bit sections, 
called nyDblcs. 

Th^re are e^ractly Ei>:tsen unicfue foLir-bit tombimiion-s of ones 
dnd zeros such that no t-wo arrangements are thMm. There ts a common 

ihorlhartfl notalion for idmh^jring these en-itaanpatlpfTfl. It g»s 
like this: 



9421 
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=b aieB=4 

eeai=i ei0i=5 

Bfll9=2 9Jia=i 

een=3 8an=7 



1961=9 Mei=D 

ieifl=^ n!e=E 
ieii=B ni]=F 



Tt'5 i canvienient shorthand EyEtembecauEt It is easy Id 

=*eme[nbBr. It atinply numhers ths patterns *ron 6 to iSt e*cepti in 
hscping with the idea of using a one character code -for each pattern, 
the rumberG 1#-15 iro calleO A-F. So, pattern 12 is called "C" and 15 
is "F", etc. It's got anothsr advantage too. The shorthand label 
system has an order which inaKea it easy to remember. If the left-most 

bit pmitionmay bB consia^red lonave the vaJueof 8; and the next 

position, the value A; md the rwnt, 2; and the last* onn- then the 
bit patterns may be converted to t^el^ labels by adding the hit values 
of thB individual bit positions. For EKimpl«^ 1910 has a 1 in the 6 
position, a ft in the 4 position, a i in the ? position, and a # in the 
1 position. 5o its label is "A" because S* 2- l6 and'A" is the 
code ton 1#. LiHewise, fllieis labeled "fi" beciuas ilhasnoS, ant 
4, one 2 and no 1. 
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The leHiitDSt bit pQSilim 15 Hlled the "most-signHitam" bit 
ttflcauM It hiE tha greatfBt bit value. It is a]90 calt#d thf "high- 
arder" bit. Lilttwi«t the rightmost bit is the "Ipist significant- or 
"low-order bit". 

Nets that all 1h& odd numbers have a one in tht rightmost bit 
posit iQp. All tti* evpn numtie-Pt, a ?ero, 

Vou can now He that the shorthand notation *cr identifying a 
four Bit data fiBld is very logical, and it ls not hird tc convart bacK 

and ^ortfi betwssn tl^e bit pattsrns irid ths pattsm code. This is 

important becauM as machine lartguagE prdgramFnera, we havB in end up 
working a lotwtthbits. This isbecauae the fiSft? and all at the 
HLf mor)' devices store ind worK with all data pcodpd as bits. 

The addreSHeeof where data 15 located within a memory device 

is likewise represented and transferred on the address bus in bits. 

^Q'ffr Since dali is stored and rctritved to and fmm the memons' 
devices esght bits at a time ( tailed a byte oi data )t it takes two 
shorthand codes to describe the *it content cf the data. A Dyte of 
data which has a bit structure of liee ft i## wOLid be id-entHied ^s 
having the two-dsaracter code a-f "C4"'. The bit structure of the code 
■For the iPttpr "A"' would be "Ai" becauEe the bit pattern assigned to 
"A" in the ASCII coding scheme it fll*fl Mfli. It's helpful to Sit vrfitfi 
a pencil and paper arid write out bit patterns and figurs out what 
th«r cades are. You should aleo-ttart wMh the redes 8-1= and convert 
back to bit patterns. 

T^at there are 25i ways tareprasent eight bits is obviojs 
from the fict that thpr^ are ^iiitren pM^ihte fir^t character*, af thi 
two character code which identiftee an eighl-bit pattern and sixteen 
possible second characters. And i6 limes 16 = 216. T+ we wanted a 
b^te of dati to represent a nunienc Viiue instedd of an ABQI toded 
character^ we can see that it could represent any value between fl and 
255. The A5*2 dMs, in fact, sometimes treat data as if it is numeric 
instead of ciiaracter data. Using the same twn-fharflcter code to 
identify an 8 bit pattern, we can convert between the numeric value 
and the t^o-charactep code quite easily. Far BMantple, Jd convert from 
"AA" to its nuineric value, we would (nultiply ]B times 14 { "A' = it ) 
and add 6 to give 166. LiKewise, to ccinvert ■'4F'' to numeric we would 
multiply 4 times U and add 15 CH' - 15) to give 7*. It'spisy to 
see that the iria!<imum value of "FF" >: 15 times lit tSW plus 15 to 
give 255. Of course, the minimum would fie '99" wbich is <9 times i6i 
plusQ. 
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How about going thp other way' If we i^inl to create the bi-t 
pattern for some number in the range of V - 255, we onl/ have In 
divide the nujnber by Ifi toget the ^irst character of the code 
(remembep to translate !# thru J5 toA thrufl. Then the Pimainder c?* 
the division is the secwid character. Kow to get the bit pattern we 
jufit looH it up in the li*tle bit pattern table. Put the tirst foLjr- 
bit pattern together with the wtorid and you b#vB an eight bit pittern 
whtch reprtsents the numeric value. Hot hard at all. Lets try it 
witni*ewrumbers. TiKb the number li9. How iHany times does ii go 
into 149? Right. And how is that represented in our single character 
code' As the letter "A". The remainder from itividing li9 by 14 is ?. 
So OUT fharacter-code repneEe-ntation of [69 is "A?" and if we ge to 
the bit pattern table » we will see that the bit patterns ire Ifllfr 
]«Al. 

It AS * valuable eitcrcist to practice convertirg bit pattern? 

tQ tharactep-codes and from charactep-codes to decimal and from 
decimal to character-codes and character-code a to bit patterns. Vou 
will find a table of all 25 i bit patterns and ^e corresponding 
character-codeB and carresponding decimal values in Appendin B. Ydu 
may checKyfliiT success With the table. 

The character' code system for identifying the various bit 
pattern-s is. as you might k»>ow or have figured out. what ir computer 
Eipcies is called hendetimal. NumbePB, when representett in 
hixadecimal, are usually preceeded by a "*". 141 is the heh 
representation for the ASCII code ^or the letter "A". This removes 
any t^c^lion as to whether the number is decimal or he»[adecimal. From 
now on we will follow that convention in this te-*t. 

There ii another conventicm which is widely used to identify 

the individutl bits in a byte. The bits art numbered *-7 frorn right 
to left. T^e hig h-order bit is the 7'bit and the low-order t>i1 is the 
4-bit. 

We dlccussed the way to rrpreHt»t the dv-cimal numbers from ft 
to 255. The sane general t#chniff» may be used to represent numhern 
from f to £S535_ Instead fi4 two he>i characters representing cm-* byte 
of data, we need fou'he* characters repreaenting si?itBinbita or two 
bytes. Now the first pair of he* characten may be followed by any of 
25d pairs af hex charactera ( 140 - <FF k So the total nunher of 
possible conbinatiDns of four he>: characters at Z5fi timpa 254 or 
45534. The address bus is sixteen bits wide. Which is why there are 
■Bactly HiS534 unique addrvssei pottibie. Mow, it is fpequtrtly useful 
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to be At>l« tc convert decimal addr«su& inic he^ade-cimal. We ?dw how 
la da i-t with a «t^l« Ay1» Qf Iwo h?M characters {S bits). Ue 

divided the num<)ftr toy 1-6 tn gel the *jra.t cfiiracter ^nd "tJlt remAindBr 
^vas the second thapat*er. The praces-s is eintilar for goin^ fram a 
number lirgsrlhan 255, 

We divJBe the number by 25i ^a get the first half of thfl 
answer. This wiH be a number between 1 and 2^5. The remainder will 
he We spccrid hialf of Ihe answ&r. Both o* thEse decimal numbepc nn 
then be converted to Iheir he]<a.dei:i.iiiai counterparts by the dividirig- 
hy-iA technique^ These he« dibits can be thefi easily convErled to 
bit! (binary^ b? loo«jng ifl:t the Table or retrieving it frum our 
biolcgtcai fncnory device. 

Le1s do an e^ainple Say i^i* want io get the binary value < bit 
(onfiquration ) of t'^e decimaJ numbe-r ^T^fZ. The -first tiling i^e dQ is 
see how many lines 25i wll go into 47^92, The answer is 187, The 
remainder i-sJfl. A line of BASIC cofls tn ao this cnmpulation i^ould 
bB: 

HA ■ INT i, NUH / 2^6 ): KB = NUM - HA 4 256 



HA is the first half of the an5w?er in decirial. HB is the 
■second half, We 5-fill have to lahe 137 and Zfl and break them into 
Iheir twD hej cDinponents. Ue do this &y dividing by i&. 167 / i6 = 
ii wriih A remainder of IS. So t^ie fifsl two he>r digits are *fiB. 29 / 
16 - i with a remainder of fl. Bo the coinplete answer 15 tBBJi. The 
binary equivaJenl of 15514 is 1«1 1 IftH flBfll ftiefl. Todouble che-cH 
DUf anSLjpr. ws go Back th-e other dirwlion afid fGnverl *BB14 to 
decimal. tl4' (I 4 ifi) ^4= 2e_ »BB= (M*lif+ll = 17d*n 
- 197. {iS7«25dl *?fl- 47972*29 =47892. And that's the 
number w* started luith. This profc^ 5lk0uld he practiced. Jt 15 vspy 
help4ul in solidifying the underetanding of tiei; Avtd binary and Iheir 
rela^iorffihips to decimal nuisbers- 



Inid* TTw VIC 



P«BB 3-1 



Th« Pr*oc« 



or 



Tht 6^92 IS a machine. Hs moving parts are electrons and ttie 
only work it does is with data. Ithas some internal data storage 
which IB ibentical in natur-e tn ttie data storage in the memary devices 
to which ii is attached througki its e^rternal connectors. The internal 
storage is Known as the machine's registers. The registers are eight 

hit; wide and Xhsr? are only ^ev^n of them. Eict\ register has ^m? 

special characteristics in the wa;^ the fi5fl2 can utilize the da.td 
contained in it. The data processed t>y this machLne is stored in the 
fiTiternal memory and the registers. Processing consists of 

iriampulating the dat* in some logical seciuence which results in 
accomplishing some desired goal. The 6592 gracessor doe^ £ta 
prccessing of data by interpreting and e^;ecuting " instruct jan>&''p 

Instructions are dats^. They A^f stored in the ineinDry devices 
as eight bit bytes which are precoded ( progra-trrmed ) to maKe the &ilA2 
do some desired pperalian. The first byte of Path instnictLnn is 
called the Operation Code. The 6562 has pre-programmed circuitry 
built in to its mirro^ipctonifsi etched onto its silicon chip, u^htch 

can decode Dpera~tiDn codes and figure Ditt wliat i~t is supposed t? do 
ne!<t based on the bit atrjcture n-f the operatiun tode. Thim logic 

come! lAFiih the *5e2. The bright electronic engineers who designed the 

6592 at MOS TecJinology bacK in 1*'75 tigurea out how to rnaWe the fiSftS 
interoret bit slr-jctures and to take whatever action each cperation 
code was desigm-fl to m4K& it do- They preplanned a 5pt of data 
TnanipulatiDn nneratiDns which Ihey thought would be useful fur a 
micropTDcessor la be able to do and then set about designing the 
macb;ne and ihe ijperation ccKles so that those operations c-ould tie 
interpreted ar^d performed. The way the processor is programmed by you 
the programmer a for you to place in the memory of the computer a 
sequence of instrtJctiGns designed to maka the 6592 da some presumably 
useful task. Vdu choDse the instructions carefully from the set o* 

available instructions wt^ich the &542 can perform. Vou code these 
irfitriictiors in the Language v^ich the machine can understandi machine 
language- Each instruction lias a specL-fin bit pattern which t5 
u>3er5tood by the d^ez to mean perform come cper^tkonaml use cn^e o4 
the 13 addressing Fnodes- 

If ycnj have an assembler you can write the 6582 instrucions in 
an undpratandflblc format whidi mates bomc senst to huin-ans when they 
read jt. T^e assembler will then convert the hun^an understandable 
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prograin inla a iiiA.chiFW undfireandabt? »quer>c« o-f bit patierrkE (bytps). 
The A^siinhlep it such 4 pragpain fon tht VlC--2fl. The next acction 
tella you how to use i4. In this saclior we will explcr* iht 
65e7'archrttccturEi its rsgistBrsp its in^tructign 5?t and its vdHErus 
&ddre««inQ mod^^. fir^t^ ±hf registers. 

Thv Progran Couitvr 

The li-bit Prograai Courrier Register IE idually two fi-bil 
rpgistsrsf the PCI, md PCH registera. These twDregisiere irp always 
iJEttfl as i piir. Tht "PCH" slands for Program Counter High and "PCI" 
stands for Progrdn Counter Low. Tcgetherp Iftey ire UH-d by ths 6592 
to form a sixteen bit address pointer. Th? £^6? voves the CDrttentsDJ 
these two registers to the address bus wher it wants to fetch an 
instruction troin soine memory chip aHachsd ta th* 65fl2. 

The Pcogram Counter tell? the A5fl2 where the ne^i instruction to 
bt B^reculed is located in memcry. When the computer ic turned Dmar 
initiaLization process occurs -automatically. This process includes 
moviog tfie data contained in addre%sP5 tFFPC and »FFFD directly irrta 
the PCL and PCH respectively. Addresses such as this whxch are stored 
ui inpintiry and point to the starting point oi sorric other program are 

calleO "vectors". This is how tfie 65fi2 finds the address of its tirst 

instriKtion to be e>!ecuted. So, every 6^i2 ^nust have fhe addr^^s of 
the beginning of t^e first program to be executed prpsinred at tFFFC, 
*FFFD. This must gtviouslybt in ROHt 

This initialization process occurs at powcr-on time and 

Whenever the RE&ETbuttiVi (available Gh sotn^ «>iparieion chaeais biit riat 

on the standard VIC) is pushed- After each i>:-pcution of an instruction 
by the £592t the Program Counter is incremented to the ne>;t 
mctrurtinn, and 50 thE program flew a^nire, 

Th* A-T«o 



The A-reg may be thought of as the Arithmetic register- It is 
often called the Accumulator. LiKe all the regietersi it is a one- 
byte I3'bit) rEgi^ter. It is the pUcE where irithmetk openalJOOE 

DCZKr. Instructions like ADC f Add with Carry > and SBC < Subtract 
with Carry) cause data tob« adc^ed to or sii^tracted from the A 
register. The A peg may be loaded (new vnlye brought into it) with an 
instruction such as LDA (Load the A-reg). lt« conteriti may be stored 
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out to some memory location wjith an instruction such as 5TA IStore the 
A-reg^^ The addr«« in memorv where data is loiOed-frDnt and stortd-tb 
is specified by further- addressing information provided to the £542 b^ 
the progra-m in a manner discussed in the ne>!t chcipter. 

Referenced to "ST A" or " LDA'Mnetnictions are referring to the 
assembler language English-like mneirionif which gets translated into a 
machine language instruction re cogni?able by the 6502. There is a orp- 

fdr one [□rrecpondence between Aaaembly Language statements and 
machine language instructions, 

The t and Y rtgiitvn 

TtierE are two other "working" registers tailed the X and Y 
regiatEfs, These are alsa Known as the inde^ registers- iTiese are aU 

eiflht bit storage registers in the 65BI chip itsBlt. The 3 and Y 
registers are used mostly in addressing fuictions as ^xpUitUd iVxt 
[hapter. The X and Y registers may both be loaded from memor/ with 
instruidions suth as LDK and LDT. They may Qe saved ^stored) in 

memory With BTX and STY instputlions. They may aUo be ircresfnted, 

deErecnentEd, and cdinpared to data in eKtemaL memory. 
Stu«P[iirTt«rffiP) 



The second 256-bytB blocUof memory (tAit9-(#LFF) is used by 
the 6Sa7 in a -^cidl way. It L^ called th« StacK. Tfhf StacK IB a 
special storage block which is autoinatic ally utilind by ceHam 
instructions. Its primary reason for existence is ta allow subroutine 

"nesting" and to illow for the smoctti handling of LnterruptSj 

BL^routmes are program segments which can be executed by many 
different proQ^a^ks, They are sub-progrimsi which are ,kjmped-to and 
returned-from. Hiey save having to write commonly used program 
segments ever and over again. The stack is the {^62's contmunicatior 

mechanism^ foe remembering ufhere a ^ubrautine was "called'^ from. The 
JSR iJump to Subroutine) instruction is explained in detail in Chapter 
5. Suffice it here to say tKat the JSR causes the program "lo jump to a 
subroutine in ujch i way that the siiiroutint can retirn to the 
instruction after the Ja3 once it is don* doing its processing . The 
A5fl2 cavFS the rvtum address on the stacK when a JSR occurs. It 
pulls itoffttiestacK when the RT5 (return from Subrcjutinel ocnraT 
Pie position of the ne:<t available stacK location for recordtng return 
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iddrEEseE Ie Upt in thi SP. Thv SP ie initiallzrd by the VIC s-tarl- 
up prograir to the valus g+ *FF a1 powtr-on ind HKSKTIime. Thfl high- 
order byi? Df the stacK addreis ie always (Bl, Thiiis fixed iraide 
thfl 6502. Thi -firfit time a J5R instrurhan ia axecuted, the iddrflEfl 
of whsre to r*1urfi tois pushed ontothe iticK at tftlTF »f« »eiFE. 
The SP 15 then decreniEnted by two eg that thft n»v value of the 5P is 
tAJFD. The HJbrouhne called by the J5R may then call eddiliDrul 
iubroutmes and the relum addrEsaes will be stortfl Qelow the initial 
return address. Tttere may be up to 123 levels of ^ubrcut^nefi calling 
ether subroutines. Each subroutine must hav? ^s its last inctructiDn 

i PTS (return from subroutine) inttruction which tausesth* 658? to 
load thp PC ^th the saved Address from the stack and to i;Kre<nent the 
^ «y tWD. ThiA tt^e rcluw Id tha addr»«a from which the subrnsutme 
was called. 

IntBmjpits are caused by an ilectrlcal signal to the £542 from 
the outside world. There are two interrupt lin^i attached to the pine 
of the 65«2. Ona of th^n, the NKI line, vill cause the 6^^2 to be 
interrupted regardless of what it is doing. This i5 taUid ihe Non- 
Hi»Kable Interrupt. This tadlltv is provided u that hardwan which 
has optical, timing requtrements nay cause thi d502 to service them 
innediately. It Is- also provided as a means of Lnroriditionally 
breaKing into the proceeiing of the nafhlrw if it i^ au^pected that 
somihir>g has gone awry in a prooran aiid there is no othsr way to eiezE 
control o+ the m achine short of -turning it of! and turning it bacEt on 
again. 

The other Hind of interrupt is a mft^Kable interrupt. A means 
■ejiie-ta to prevent the interriipt from tieing serviced. An interp^ may 
be '^maEked" (made so it can't be seen by the £507>by thi means of an 
"Interrupt disable'^ bit in the Procetsor Status re^fi^ter. UisluMv 
interruptc ar« those ^Die electrical cenrwctions are to the IR(3 T^n 
Df the «3SZ. 

Both kinds of interrupts are handled in about the came way by 
the d5ft2i Thi d?QZ -finishES processing the instruction which waa in 
pfoaress when the interrupt signai was reccsgnized. It ihen saves the 
PC an the stack just as i-f a JSR tiad been eKecuted. AdditLoneUyr it 
saves the Proceaior Status Register on the stack and decremecrti the 
stacK by three. It now laads the PC with the address found in 
location IFFFA and IFFFB for a HKHnterrupt or tFFFS and trriTf fnra 
non-maskable In-terfupt. Theie locationfl muit h^ve been pre-Tirogpammed 
to contadn the addressee of the programs which were written to service 
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the interpuptB. 

The interrupt prMrssing rwtines must be enited via a FT] 
instruction (Reium from Irterrupt). This acts lil« the PIS 
ins-b^tion except that the Procisscsr Status R^O^SterlE reloaded from 
the stacK before t^e PC U pulled ffcm thB stacks. Inthj.) fashion, 
the interrupted program may continue where it was interrqsted and the 
statue {yf the machine wlU he ac it wae tt the ti ne of imlepri^tion. 

The sticK is also used by the PHA and PUP instructions to 
store th* A-reg and the F-reg respectively in the etacK- This is used 
to pass infornmation to the ^ubnxitjne. Hare intormation about theee 
instructions may be found in Chapter 5. 

The Pnxitsiot Stitui Riglttir 

The Pr-oressor Status Register is a collectior 0^ eight bits, 
aomtime 5 tailed flagsr which reflect anC Lortrol the operaticin of the 
65^2. The bit a^^ignment of the F-reg is: 

P-reg bit position 7^543216 

Status-bit labet h*> B017C 

The Hegativ* K^ 

'N" is the Nectative-Oit. It le tjmed on by the prDceseor 
i^3un the execution of certain instructions. It reflects whether- the 
nsjlt of an addition or subtpictlcM-i is r*gative or not. A 1 value in 
the Negative bit indicates A negative result. This tiit is set by load 
instructions and compare irrstructions too. Sea the chapter on the 
65^2 instruction set for a complete e};pl.arLation of each instruction an 
how eacl^ affects the various atstu? ^i\s, 

ITie Dvt^^lfiw at 



The "V" bit is the overflow bit. It reflects whether or not 
'two's compiemePt" overflow has requited frorn i SBC ISiiitract with 
Carry} instruction. It is also set by the BIT instruction. Seethe 
descriptions of those instructions for a more complete ejcplanation. 
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The "B" bit ts set by tht prcicBBHDr when a BfiK inairuction Ie 
c^cLLrted- Ths HRK instruction cause-s an interrupt Id mclit. It is a 
3i:rftwire intEFTupth J^d mo^lly in debugging machine langudge 
prcgrtns. Thfi fiRK interript ia. pre teased aim sat like a maEkabl* 
interrupt- The 5itr\f vector is usad by thD {&5ft7 to firud the dddrsss of 
IhE intarrypt proccessinq roulineT The D^ly wsy thr flTDCESsing 
poutirw can kr»ow If tf^e interrupt vas i software or hardware interrupt 
ifi by Bkamining the "B" bit in the Ptdcbssct Status RSgister which has 
b^^ri stored on the stack. Thi B^k is not maskaQlei but it u^^ th^ 
maskable interrupt vector, Alsfl^ the rttvrn adflrsss stored on the 
fttack ie thfi aaarcEfi of tht BRK inslrjctlDn ;)lus two. 

llw DkihI Hodc Bit 

The "D" -flag in the P-reg is a cue to the processcr to do all 
ADC and 55C instructions in Denmal inode. In decimdl mcde* th? da^ 
being added or subtractBd will be ufiUFiBd to frs composed of two 
dacimal digits per byte. Each diqit is [:aded as afcur-bit pattern 
having the range of values tO - If. Tht range oi values which can be 
tontained ina byte is*-?9 deumai. The naniB p^ this data typr i5 
Binary Coded Decimal (BCD). 

If the DBdmalmodais dear, the ADC and 9BC inEtructiois 
will tret* the data being idded and subtracted as eight-bit binary 
values in the range ft-255 . 

The "D" bit may bf ui a.rui deireb hy the pragram untn SED ind 

CLD instructions. 

The Intsm^it Disable bit 

The "I" flag is the intarrupt-disable flag. It may be set with 
the SEI instruction unS cleared with the CLJ instruction. When set. 

only TOT-maiKable and softwtrf interrupts may ottur. Whan ClDir» ill 
inten^its are enabled. 

T^Zanibit 



The n" Hag ii ui like the 'N" +1*3^ by arithmstic *ftd Load 
and compare instructiuns. I* the result of thew nperations gives i 
lero result, the 1-fUq is ut. Otherwise it is cleared. 
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Th« Carry bil 

The "C f^ag is tht Carry bit. It is set by additioTi 
^ublrattion^ shift and campiarv instrkictions as well asthe specific 
SEC and CLC ins true tions. 



The N| Vi Z and C bits nay all be tested by conditional branch 
instructions. A full eKplanaticm of this facility is provideth inihe 
loUawirtQ (haptars. 
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The inslructiorifi within the prograin which contrDl Ihe procflssor 
cauH it ta either- If load data from irEmar/ irrtc one ot its internal 
regiEters or 2) to move Oa1a trom ofie register to ariplfier dt 31 to 
-jtore data Ir-oni orw o-f the registpr^ into memory or 4> to modify the 
data in one o* the register! by some arithmetic operalicn or I) to 
ciUBB d Changs in the flow ot ths program. 

The 65fl3p at it decodes eacti instructiDfi aHer having -rptchpd 
it from mEmory, di^coverfi three things about the instruction: i) the 

rnjnibfr ot b>^te5 the instruction take^ in m&rrflryi 2) thp addressing 

mode □* thp inatnjction, 3) tlie operati-nn to be performeb. The 
Dcerihon code takes only one byte for every instructiwi btrt satf\i 
instructions n«^ to supply the prncpssor additional infornnSjcn 
heyorrO the xi-ctx1e. Thit lE cither address information or data, ii, 
tor example, an instruction'? pii'pOM IS lo direct the orocessoT to 
store the data contained nits A register into some location in 
memory, it needs to provide the 65e2 the in-iofmBtian as ta -where to 

stort It. This roiildtaW one or twQ additional bytp5 depending on 
the addressing mode- 

Each operation cod* has roded into it the information 's to 
whit iddressing mods should be uni to actomplifih the desired 
operation. The W92 has thirteen aflflr^SEing modes- 



ABSOLUTE HODS - Absolute adressing requireH a three byte instruction. 
The first is the op-ccnit ind tht nsT* two are the twobytei of iddrest 
inforntatitm. 

You recall that it taHes two bytes ( sixteen bits ) to 
specify art iddp«s in the i5B2 address spiM. This is tiecause the 
address bus is si*rteen bits wide. The ^irst byte of the tvi^ byte 
address is caUed ttie high-order byte or the nOBt-signilicant byte of 

thfi iddrtss. The second b^te is the lov-order or l«ast significflnt 

byte- These are sometimes abbreviated the MSD and the LSD- Thei5e2. 
when it ■'iecutec instryttjons with itsoliite addressing, simply fstchiet 
th» niKt two bytfs after the op-tode ind pyt* tMem on the address bus 
when it does the memory access operation specified by the op-cotfe. 
The i^emory devices, which are a+tached to the iddrsss bus and tfii data 
bus and the conVol b^r are signaled by the R/W signal and lalce the 
address information o** the address bus to select the memory location 
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to either store dat-a into or read data out of. If the R/W signal 
^igmtie^ WntBh it vvill take the 6itA from the data bus and slore it 
inta the ifiepncTy locaticn specitied by the address an the address bus. 
If it is 9 Pead signal, it will taKe the data already stored at the 
specified location and load it onto the data bus w^i?re tiie 656? will 

■find it and do whatever the □p'--code indicated should bp done with itr 

In absolute IP ode F the address js siored after the op-code with ^s 
least siqnificani byte immediately foiiowing the op-code ar>d th« (tiost 

significant byte following that. E>[arriple: 

LDA 14521 

29C9 AD21« 



This IS an example ai both an assembly language statement on the 
-First line and the machine language -following it_ The format is ihe 
uiD« is that which appears m the Bcrten when you run The Assembler. 
The assembly l^ngi^ge mnemonic is LDA. It is the assembly language 
equivalent of the op-code- It means Load the A register. Tne 
AssrniQLerr which fonv^rts assembly langjage into machine languaqPf 
decades the mnemnnic and the following operend and produces the 
machine language which appears or- the second line. The Assembler 
also prodiicps tassette OT dia(*tte file tontaining the machine 
language which The Loader can then read arbd store in the appropriate 
memory locations, w^erfr 4iridlly it can he #M*cuted as a ^ogram. 

For now, ]«ts just louk at the twc statements as ttiey appear 
here-. The ««?1 is called the operand field. It specifies to We 
6502 where the data to bo loaded into tho A register is to Fie fOLmd. 
The 29a is the address where the instriJctiDn: is iouted. It waa 
arbitrarily picked for this example. The secc^ fieldi KACr is the 
tifr representition #or the op"tode. Foilowing the opnctrfs is»21t the 
second byte of the address specfied in the assembly statement above. 
It IS followed by >4St the first byte of the address. This is the 
order the 6542 ejipects to f^nd addresses . The 6^42 proteges this 
instruction when its Program Counter tias the value of t^ftCO, Jt 
-fetches the op-code at that address and decoder it and e>[eciites it in 
the followin<| sequence: iMt determines from the r^code of IAD that 
this IS an instruction to caiise the A register to be loaded from a 
location whose address it will 4ind immediately after the 6p-code. 2J 
11 feJches the neyt byte after the op-code, t2\, and puts tt on the 
leasl significant byte of the address bus. 3) It fetches the ne>it 
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toyte, I45j and puts ii en Tht mosl Bigni-ficanT byte of the addr-PH 
bu5. 4) 11 SE15 the R/W Iinp to R. S> h waits for ihs meriDry bp*:ce 
to get the BpeCi-fiFil dats arnj pul il im the dita bus, 6} H r«ads 
the f}4ta ^rDm the data bus and ^uts it rn it« A rvgistpr. ^. l± 
increisas trvs PCHiPCL register pur by 3 » thai it now points to ihe 
rie]<t D[fcndp. 

Thi^ i4 a -{^bVipll^te insirui:'tiDri cycle. 

ZERO PAGB HODS - If yinu take the sixt^^r hi\ address bui and split it 
iff hii*, tfie ■+ir5l eight bitt could thought of ac a "page numbsr^' and 
thp second eight bits cculd then represent the addre^^ 4 from 4 - 
255 ) within thit page. This- would mean that there art 256 possibJe 
pagas, each with :5fi msfnory locatims. lerc Page would then repneHrt 
all memory locatigrs -from m99 to 199FF (& to 255 i. Page one ^oulb 
in mediately folLow. ccntaining Ihe addr-esses (SIAft tot^lFF 1256 to 
^11). 

These are Iwd pages which have special sigmfkcance for the 
iSfl?. Page rera adbresses may be specified with »riain machinp 
language irffi-tnjctions which are specifically ccuJerl^ 45 Jero Page 
addressing mode. Page on? is dpsig-nated tJie stacK page as e^^pIal^led 
M\ the previotrt tha^rter. More about that later. The desigtiPr? 0^ the 
6562 decided it vould be good to have an addressing mode which allowed 
t^e 6562 to eKecute instructions faster and would consume less memory. 
The Zero Page iddrc^^iog mod? wa^ pari of the ^uluton. The 
addressing mode is specified as a part of th« op-code. En decoding 
the DC-cade, the 6502p uptsn determining that the addressing mode is 
^Pi then knows ITiit thr ad^re^^ to b? gcc?^§ecl l§ in zero page. It 
therefore has only to load one more byte of addressing datflp the ki<i^/- 
Ofder or least-significant portion of the address. The high-order 

half af Ihe addre» wil^ be forced tQifle by the 6^02. Thenforer 

Zero Page instmctions are only Iwo bytes l&ngj the op-code an* the 
addrass within xmro page where the data is to be S'^ored or found. 
e>[ample- 

STA H7C 
2flCe 85 7C 



The left^irrow 1% 1h* code Id the issembler thji thift n a Zero 
Page instruction. The address specified by the ope-rand is »9*7C. 
This IS a Stor* the A-reg jnstructLon. Op-code 1*5 c*us*s the 
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contents of the A-r«g to be stored into ihe spedlifld zero page memDry 
l«i.tiQn «M7C in H^ia o)iaiiiple>. 



IHHftDlATH HODS -Some instructions- may direct the processor to find 
the needed data immediately after the op-code rather tiian having to go 
to same specified iddre^s to 4ind It. The» are twc-byte 
instmctionsi one for ttie op-codei one for the -data. They ej<ecLJte 
even faster than the leropage instructions becaLTse the £542 needn't 
put an^thirig onthe address bus or wait for Amtherfetch cycle to 
complete he-fore it gets the data it needs. Si^ample: 

BBC 1125 
20C» E9 19 



Ntrte bert that tht opinnd field hia a "tt" orvcieding the data 
value. This is the cod* to The Assembler that this is an Tmmediate 
M&de li^SlfitfUOi^. Koteal*0««trt6"l''pfec**d*lft*valuft25, The 
Assembler recognizes four data typesi dedmali heacadecimali address 
eKpression and ASCII character. He:< numbers are indicated by a 
leading "I". A^Cli charactgrs by a " ' " dncinal numbers by a first 

character o€ e-5, and address PKpressiDns everything else. In every 
casep The Assenbler will convert the sped-fied datd value into binary 
(or hex li you wishi the Ehorthand notation for binary) which la aU 
the 65S-Z can ultimately undBrstand. The second line displays the 
machine lartguage in the same format as before- The first field is the 

address in he>L where the instrtJctiDr will reside* followed by the op- 
code in hex, followed by the data value in hex also. ChecK -for 
yourseH that ii9 is the same thing as decimal 25. 

The A^sefnblef h^g an DvliDn you may wlect edch lime it :& nr\ 
to print the addresses and generated machine language in Qithar 
decimil or hev. The file which is ffeaUd tat li^ading by Tht Loader 
will ai^vflys contain henabeamal. 

SBC stands for Subtract with Carry. It is an instruction to 
Subtract the SjiBcif led data val^je from the cDotents trf the A-reg *nd 
to store the result bacM in the A-reg. 

One further note: Host instructions may 4ie specif led with a 
variety of addr^^^jng modes. The Assembler examinee the operand field 
Id determine which addressing node is being specifi-ed. It then 
generates the proper machine language op-code to indicate both the 
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□peraiicn ta bB FHr^Drmed ind the addreasing maQe. As an BKAitLpl^r 
"SBC t4FF3'' is An ibsolut^ modi uareior Gf the SBC inatructicn and the 
op-code for it is lED is comperei* with *B9 a« in the above eKdmplv. 
Apf»rdi>i A ccirialns a hEt at all inatructionsand their dllowdble 
^adr^ssing modes. 

IMPLIED KODC - The implied mode of ddbressirtg is the fastest errecuting 
and the shortest iriBiruction length. In implied modei -only tha 
intprftsl registerfi o+ t^e fi582 are addressEd. Beyond the op-todSf no 
more inforina-bon i? required, sd implied mode only taties one byte. 
Snamples: 

TAX 
e23F AA 

TAY 
a74e 18 

TAX cau^3 the contents ot the A-reg to be transferr-ed to the 
X-rog. TVA causes the CDntenta af the Y-reg to be transfeiTefl to the 

A-EKG HODB - The A-r*g is sometimes called ^f Accumulatc^r. TTiis it 3 
carry over from more primitive timeSi In Any flventr Qommo^w ar>d HO? 
Technology chcxjse to re-fep to. the A-reg Hnde as the Acfjmulator Mode. 
Call it what you hVa. it is reilly an in^plied mode. 1h A-re^ Mcfle, 
only the A-reg arid the Carry, Negative and Ziro bits of the Status 
regiEter are affected. The A-reg "node instructions are vahd only -For 
the "Bhiff instT^tiwiB, ASL, ROL, LSR and ftOR. ¥ar more ir>fopm»tlQn 
on ihitft ifutructiDnsi see the next chapter. Q>iample5: 

RORA 
«iA fiA 

ASL A 
021B 0A 

RELATIVE HDDS - There aw three classes d+ instructians which CkiM 
the tlflw oi IhH program to change- The JHP arri JSR instructiDnK are 
explained in the following chapter. Ail three types of instruttions 
accomplish crogram (low changes m the 5am«g0nfl-ral way. They cauEe 
thi PTDgramCouitef register- to be modified. The PC is Ifit register 
pair which points to where thie neift instruction is to be fowid in 
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memory. It is airtama-tically incremented by the instructiEyi length 
Each iitae an Lnslrurtidn \5 ^aeaiXa^* The instructions which modLty 
the FC caLJse the program to ""ta^e a branch". That is, the r»i.t 
instmctitin to be BKecuted will rot be the one immediately foll-nwing. 

H win be fouid at an address wh:ch n determined by the addressing 

data suppied by the branching instruction. 

The adddressing information supplied by the "relative mode" 
instructions i^ a ^.n^le byte of data \^ich fcllcws the op-code and 
which is added to the value of the PC to detefnnine the new PC value. 
The branrh is ta an adAres.; %i^ich is the specified number of bytes 
away from the branch instruction itself- The address informaijon is 
[ailed the relative displacement. 

Thess instpucttors only modify the PC scmelimts. They ar^ 
cal]4d ccnditional branch instructions. They lest the status of a hit 
in the Processor Btalus Registpr and the &'5i? decides at the time the 
mstpuction is e^etutpd whether to Branch i modify the PC 3 or not, 
based upon the value of the bit being tested. Sxanple: 



NOTA 



CMP H-'A 
BhJE MOTA 
JMP PROCESS!^ 

CHP *'e 
BEO PRDCE&EB 



e3B5 -IC 7D 6'* 
0368 C9 42 

630 A re CC 



This 15 a short pra^am ^egi^ent which first compares the 
contents of the A-reg with the character "A". TTie fcirinal o^ the 
program listing is the same as that which is produced by The Assembler 
when printer output is employed. Mote the Immediate symboli "4" and 
the "chardtter" symbol " ' ". The function of th* compare instruction 
is to set the 2ero bit in the status register if the compare proves to 
be a match. Otherwise the Zero bit is cleared. 

The uistnjctiDfi after the compare is the conaitional br&nth 
instruction. It is a Branch Not Equal instruction. If the result of 
the compare results in the zero flag being sett the branch will noi 
happen and the JKP instruction following the BNE will be eT:ecuted msft 
as usual. If notp the next instruction to be executed will he the 
instruction at 10393. 

Here ^ou see one of the great advantages of having an 
assembler whith allows you io use labels to identify program 
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lacatiDna. Ycm. the prcgrdinmcr an u«b iricaningfqjl ^vmbDls tD rvfer in 

some address in memory. Yeu wnfe th« d^^mbly lir^guigt progrAm 

wj-thDut regard to thp aclLial dddr«^^cs erf each Instructicn in thfl 
program. If ^dej wirt to caust ths progra.m tn branch to saiiiB 
instnjctiar aome where in tJie ppagnm, you putaUb-el infinglifih on 
ihe insfructicn and TKe As«?mbler Aulorndtically compulfle th# Addrcit 
of thff infiiruction f or ycu. In this case 4h* symbolic labcL i& 
■MOT A". 

AaEcmblers which permit this capabiliiy an caUad symbolic 
asEffniblprs. Single-line issembleri such &s is incoppnritBd tn VICHON 
are Q#vcrBly liiriitEd by their lac4( of this feature. 

The generated machine ianguage is particularly interesting 

hero. Tri« bylp +DllDwing thB BKE op-codc ic i 'tea". fliUtive 
addre^ssing inean^ that the value tound in the byte after tha Gp-ccde 
ia the number to be added to -the PC to *ind the addrett to be Branched 
to. That IS I if thf 65ft2 findsthitthe sidtusbilbeingleatto by 
thE Branch irstrurtion indicates, a Branch should be takeni it then 
add^ ttip vaIue fDund in the byte after the op-cada to tha FC. (It has 

alrft^dy intrsmpnted the PC by two before testing tht status bit). Tht 
AsEflFTbler aulotnatically compute-s the difference between the address of 
thfl instruction f ollQwing the BNE inslruclion and the beginning erf the 
instruction HOTA. In this case the amsunt of ad^attnent is three 
bytes. NOT^ occurs three bytes past ths address C3f the JMP 
instruction. It ib pos^itiSe to speftfy i tarvM^anil branch forw&rd 
by ae much as 127 b-ytes or-bicKwardsas much as 128 bytes. When 
bacl^ard branches are specified^ the displacement value in 4he byte 
after the op-cadi mjBl contain i negative nunrbsr. 

We mentioned earlier that a single byte may npresent the 
decimal r-angc of 9-7^^. far special ^tuAticns such as the relative 
brar][:ti instructions it is convument tn allow the 256 possiblt valuSE 
D* the eight bits to represent a range of numbers from -128 to *127. 
Ta Accom[}dite this needt a system was devised to indicate neg-ative 
numCrera. It is tilled the two's comptemefit syste-nii It »ims « ^ttle 
strange at first, but with a little practice itt too. can be mastered. 

Negative one is represented at IFF. Hea^tiVB two ia 
represented as »PE C or 254 in regular decimal ). You can convert a 
number to its negative by subtracting it from 256 then corverting the 
rsiuH tn hw. Fop BKimpli* the hex rppPtMntation of -i i* ?'*" 
*-25*-»FA, This system is pupularwithcomputep designers heciuse it 
msKes arithmetic easy. Mote that 256 in hen is tftlM, Biiitricting 
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siK from tfllfte give« If^A, But IftlSS takes two bytes. The maximum 

va]i>e of one tiytr is tFF. If we add one to »FF we gtt »*ft with i 
ciTpy of one. And with *FF representing -I it is very nice that when 
we add 1 to -1 we get 9. LiKewisc when we add 1 to minus 2 ( %FE ) ve 
get IFF (-1^ Anothe-r adv&rtagtf of thifi fiystsmis that all the 
negative numbers haive the high-order bit on ( leftmost bit value » 
1). The positive numbers ore l8H«fteflea«4) to t7F( 61 11 ill] I 
and the negative numbersareise ( IMfleeSBktolFF ( illl UlU, 
rit is rwt coincidental that the N-flag ^Negative bit of the Status 
Pcgister) is ut tvsry timo anv arithmttir ope ration raeult^ in a 
value with the high-order bit on. 

The Assembler will automatically convert relative branch 
diiplacEiiiEnta to the proper value for Doth forward and bicKward 
bpanches. And The As-sembler will sLso allow the expression of 
negative numbers in the more familiar formtt of decimal numbers ( -34i 
-\2Zi etc, ) and do the conversion to Ih* two's roiriplemtnt valw tor 
you. In dBbuggingi hov/ever, it sometimes comes in handy ta be able to 
do the convepsior yourseH and is worth Iffiowing how to do. 



1HDBMHDHDDB5- The X register and the Y rsgistep are sometimes called 
the index registers. This is because they are used as inde:<es to 
data. T^at is, the relative position of data in a string may be 
addressed by specifying a base or starting address af the stririg plus 
Eoma position indeK ta indicate whirh data element in the s^ng is 
being addressed. The X and V registers can be used iwith ceHain 
instructiHis to be ^he ppsition inde>:. The instruction specifies a 

bAM- address and an inde;( register. Th^ £367 add^ the value o* the 
indejt register to the base address tn get the effective address of the 
data to be accessed. This is a very useful capability. The following 
prcfgram segment illustrates thE use of inde^iCd addressing to move a 
string of data from one place in menhory to mother: 



STR1NG1 £Q\i «e4ge 



s^ee 



EtTRINGZ EOU *94a9 


e4Be 


EQU 12806 


2eee 


LDX «]0 


2e0e A2 SA 


LOOP LDA STRINGI ,X 


2662 GD ee 


STA STfilNG2,>! 


2«fl5 ?D 30 


DEX 


sees CA 


BPL LOOP 


2809 L0 F7 



04 
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Several new things are prsMnted in this progrim ssgiTienl. Thf 
tint tvo St ate ments cause Th* AssBHibler to Equate a syribolipc label 
\rfith a specific iddPBSS in memDry. For ever? ?^jbsBquer-h rfi^erence ta 
Ihe labe-lbeingEQUated (STHIHGl intftisexampieHTie A5s.arrt;lBr will 
know that Ihe addrsaa being referred Id is the cpne in Ihe operand 
»Mift oi the EQU statement (ift-lflftX Kotv Ihe gHnerated machine 
larguagt which fDllc3W5 the sia-tementi LOOP LDA STRINGl.X. Tht 
address **4*ft is autQinatically generated by The Assembler i in the 
required loworder-bytc -first format ). 

The third EQUate tells The Asseinhler what value to assign to the 
Location Cojiter. The Loci-fion Counter is The Assfimbler's tquivilent 
Qf the dSftE's Progr-im Counter. Thr diffsrpnw is that the Program 
Counter is an actual hardware register contained on tha A502 chip. 
The LMitan Counter is The Assembler's symbolic equivalent □* the PC. 

The address printed en the fnathine language lirwifler each afitembly 
ijtstructinn is the value ai the Location CDuriter -for each instruction. 
It shows us w/hereths generited machine language vail be in memcsry 
whsn The Loader finally loads the program into memory. Every EQO*te 
statement sets the Location Coijnter to the address expressed in the 

Gperand field ot -the statement. 

The LDJ; instruction loads the X-re^ with thie viluo Ifl. The 
next two instructiims illustrate the inda>[ed addressing mode. The 
firmt instructigr Joads Vif A-reg with a byte of dati found it address 
H»*A. The address specified ir the LDA instruction is ie4M, Th* 
contents of Ihe y-re^ are added to the specified address by the i5ft2 
before putting the address on Ih? address bus. Since the X-rtg has 
jjst been loaded with the value le, the address where the data will 
came from ta be Ibaded ifito the A-reg is 104G0 4^ (A44^A Dr»44eA. 

The next irreiructionturns right arojid and stopss that same 
data bacH in memory at the address IflftSA. So we now have three copies 
of the 5acne byU of data. One cnpy in I91SA, ant in te49A and one in 
the A-req. The ne!<t instructior, DEJl, causes the X-reg to be 
DEcrsased or decremented by 1. Since it had the value of Ift coming 
uito this instruct ion f after the instruction is snetutsd, it will hive 
the value of 9. The rw!<t instructior. BPL LOOP, will conditionally 
branch tn*he instruciiDnwhit^ has t^e label LOOP. Kotethisis a 
backwsrfl Branch of ? CytM. The gtneritBd machine language value of 
hciw far to branch is »F7. Hememhep about negative hrar*ch 
displicemflftts? 35d - 9 - 247. 247 V li - 15 with a renainOBrof 7. 
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Hence the hex valur oi -9 = IF7. Convienientlyp The Assenblar made 
thai caUulo-tion for ui> 

The BPL instruction tests the Negative bit of the Status 
Sagisttr. BPL sUnds for Branch if PLus . The Negative bit is 
affecteti by es^ry CKecution of a DEX LnstructLon < and many oVitr 
instructiDns as well }. If the X-reg was zero before the exe'cutionof 
the DEJ[| the result of the DEV would be a negative number in ^e X- 
reg. The hiegative- bit would be net to one. The BPL tests the 
negative bit, H it is not a one (not negative) the X-reg must siil! 
bB positive or zero after having been decremented by the DEX, 

The br-anch wiU be taken backup to LOOP, The A-rt^ will now 
be loaded from address te4*9 and stored into address (^489, The X-reg 
i^rill be decremented ag^in and tested to see if it went negative yet. 
Once againi it is positive i it has the value & now X. TTie branch 
will be taken bacK up to LOOP' the same process will occlt once againp 

this time novirtg a byte from le^S to IB438. Once agdinr t^e X-reg 
will be dEcrenerted and tested and foEind not-rkegativep The loop will 
be execEited a tntal of 11 tieneSf with the X-reg varying from lA toBt 
the aMrpss- of dtta &eing leaded into the A-reg varying from >t4flA to 
t0444p the address of where data is moved to varying from tfr49A to 

This is the prixessby which a wide variety of repetitive 
operations are performed upon data with the ^362- This is a very 

standard Ihq. [f it sti^l seent myBtenouc to you read it aver again 
and when ^Me get to the section on actually using l?^e Assambleri The 
EOitoTf The Loader, The Monitor, and The Decoder, we will create *n 
actual program which does just this proceea. We will execute the 
program one step at a time wit?i The Konitor, watching how everything 
worts and seeing the registers and the memory locations changing as we 
go through tht program. 

There are four modes of addressing which are ciiied T'^ieited. 
Both the l^peg and the y-i^g inay be used in inde^^ad initructionB and 
both may be used in combination with absoulte and Zero Page modes. 
Like the abaQliJtea.nd ZPaddr-essing modesi the absolute ,;C and ZP,X 
instructions taWe three and two bytes respectively, Tha Y-reg and the 
X-reg function identically in their respective modes. The -four 
indeved mDdiElhenareTab5rX;IP,](7^B,Y ;ZP,¥. 



IHZHRBCT HDSX - There is only one instruction whii^ uses the simple 
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indirvct mode of dddrtssmg. This is the JHP lAddr) IrKfnjciion. The 
parenthesis irajnd the absdute addrft^s- sigrifiee indirect. What 
happ«nfi with tfii indirect jump i% tha fallDwing: 1} The A502 getc in 

addrp^S -Froifi the two bytes immediately fDllowing the op-code. Rather 
than load the PC with ihii value directly* it {fitchew an address fram 
thp ^»ci#iPd rrreinory iDtJttor and the memory location immediflttly 
follcwing it. This is the address which it loads into the PC. Thu8- a 
changa in the program flow ifi f aused. 

Td state Ihi^ ^nflthrr wayr -For "tfie JKP indirect to worK ks 
desired* there must be an address pre-stored somewhere in memory. The 
iTHF inctruction nust iell the £562 where that addJ^^a is locaied in 
memory. The 6592 swill then load its PC with the addre^^ stcretf 
thereir. Such a pristored address is called a vector-. BASIC has 
several v*ftflre SAved ir We tirzt lew pages d* memopv which polfit to 
varicxi-s processing proarams- 

Vectors are convienient waysof allowing the flanible design 
of opiratmg fiyetflme ^uch thit new verfiiona and updat^^ to the 
Dperatinq system can be i:Dmpatib1e with the eld versions. Programs 
w^ich need to u^e the vari-m^ roLitin?^ pcEnted ta by vECtOcs will not 

need to be changed btcdJK D-f a different ^ocdlionof the routins in 
the nev version. The vector will tie the only thing which will have to 
be modified to allow compatibility. 



dNDIRECDiY -This mode is somewhat similar to the indirect made 
QifiCUEHd above. The ihcws iftstruciion was applicable ooly to the JHP 
instruction. This mode is applicable to various data access and 
manipLjlaticir instructions. These inslruclions are two byte 
instriicticins. The second byte of the mstruttion specifies an address 
in nrc page- Lite with the previoue ntodB* there must be an address 
stored at the specified location. The big difference here is that ihe 
Y-reg is added to the addr^is. foiind in i^ro p^g? to give th« £582 the 
eventual abdress cf where the data should com* from or go to. 
The Ondir^rV node is actually LJted e>iactl>> hUe the addriY mode- ]t 
19 JHful for dDirg Impbi The Emly differenu is th«t the ba» 
address o-f the loop ie etared in Zero Page rather than specified 
directly by the instructlDn. The instructiDn then specifics the Zflro 
Page location of the b*K iddrtHi This is a very handy way lo 
program a subroutine which is used at different tines and called from 
dl-Fferent enlaces in the miinlir* orogriifl to do the same genaral tasM 
but with diffe-ring sets of data. The base address of the data to be 
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manipulated by the stiiroutme must be appropriately set up in 2era 
Page each time just before th» siisroLitine is called. The subpoutme 

itself never has to change anything. It uses the zero page vector to 
get the daia it's been called to use. E:<ai!ipJe: 

SUBPA LDY *i4» 
LOOPA L-Of* <*7C),Y 
STfl <»Bej^Y 

ePL LOOPA 
RTS 



TLerei the subroatinei SUBRA. is desi^^ned to do a general 
purptrae inove of ^at* from some location irt memory to some other 
location. The numlier of bytes to be moved is found in location »9fl4ft. 
The loEatloTi ot where to move the data from is fcund in I007C uvA 
I447D. The address ofwtiere to move it to is found in locations 
ifr^^fr «nd t^^^l. The callirig program must eel those locations up with 

ttifl app^'opriate values for the subroutine to tunrtion as flesired. 
Note that no left arrow is required tor the Cindei(Bd>,Y mode even 
though t^ specified address is always in Zero Page- 

{IMDIRECTJO -This is the last and probably the least useful 
tddressinQ mode provided with the jS87. You may have guessed that It 
is »milir to the previous mode' It wKiuld be i lot moTE uHful if it 
were IdeniiciL except for the register used. Unfortunate tyi it isn't. 
You ^ojld notice that the Xis inside the parenthesis* whereas ir> the 
previtjw -mwJrr ttit Y is OutSitfP the parenthesis- This is the 
important distinction. The parenthesis indkate the "inilirection". 

In the previous tKanpIOf the Y-ng was iddeO to Ihe address tound in 
Zero Paget end the reiult Eif that addition provided the address of the 
desired data. Here, the X-reg is added to the specified address to 
find wtien m Zero Page the vector resides. The K-reg is therefore an 
tnde< to a table of vector stored in "Zero Page. This mode is not 
useful, therefore, in the saije way th*t the other one is. It might 
find some uit in Lfmsual situaticns ^^ere ttiere is l nerd ta have a 
list of addresses of data bytes and a mitine is needed ta process the 
various data bytes. Such a routlna would step through the listi an 
address (Iwu bytes) s-t a tlmsi using the X-rcg ta bump thru the Liat 
and tD point to the appropriate address at whii± the data wUl 
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mods. 



bE found. Perhap?- ynjcark find «om« better Lifift erf this 



TFi^u lAEt fajT chftpterc have bftfln fairly pac^d with LnfopmallEvn 
wi the *forkn»ga of the i5ft2. It wiU Be reMsaary to write some 
progrim^ and to enaiiiine Itie programs nf others to g*t a com-foHab^e 
feeling about the use oMh§ virioui instruction's and flddre^aing 
inodeB. Thp rwint ctiaptsr will present every svailablo inttriiction on 
thp fi5ftZ, After completing i-t, you will bi ahla to start to tiHe 

corrtro] at your computer by writing powiHul nichine languagt 

prograini. 
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dSdS — Ins-fcruc^ion 9m± 

Thvre are 56 separate instructicns which the 4562 has been 
deiigned To e«ocutB. There are d«»a two "p«iJdo-op inatructiora" 
which are not d part of t^ie A^02'fi irs-Cnjctior set but which The 
Assembler urderstanda. 

There tr-t 13 iddressing niG0ei.. 3ome inatrudlons are limited 
to a ■inqle addreaairg mod^r atherc ar« capable of utilizing up to 
■Ight. Most of the inEtructionB are quite simple fuTctiorraiUyf and 
require only i senteriCE or two to deicribt their chordcteri^^tiES. We 
will Eowr these -firs-t. 

Regiittr-cnly tnttnjctiani 

TAX - Transfer the contents o4 the A-reu (0 the H-rt^q. Ot\\y the 
receiving rpgistsr i« maditied. The Zero bii of the StatLn Register 
is set (mftde to have the valufi L> if the valiie transferred i^ ?erop 

DthepwiBB Hi5deaj'ed<made tohawpttse value ft). The Negative &it 
q+ ths Processor Status Register is set If the high-order bit of the 
value transf trrc-d is on (value i>, else it is cleared* 

TAY -Transfer A-reg to Y-reg, The A-reg is storsd intotht Y-reg. 
ThE siiPt notes dpply as with TA](. 

TTA - Trans-fer Y-reg to A-reg. The ¥-reg is stored into the A-reg. 
The same notes apply as with lAf. 

TXA - Transfer ]f-neg to A-reg, ThB X-reg is stored into the A-reg. 
The same notes appW is. with TAX. 

TtS - Transfer X.-req tn Stad( Pointer. The X-reg is stored into the 
SiitV. Painter. No s-titut bi.ts are a+fected. This is the only way Erf 
initializing the Stick Pointer. 

TBI - TrintterStacH Pointer to: X-reg. The Stack Pointtr ii storeil 
into the X-reg. The same notes apply as with TAX. 



ESC - SBt the Carry bit. Th< Carry bit is act to value i 
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CLC - Clear the Cirry bit. Th* Carry bit is cleared, 

68D-SEi the Decimal Hods bit. The Decimil Hode biti? u1 to valua 
1- Th« Dedmal mode of arithmetic a enabled. 



<XD - CLflar tftt Decnal McxJe bit. The Dflciiral mode of operation is 
difiabltd. ThB Decunal Kode 
bit is deartd. 



CIV -CUar the oVerflow bit. The oveHlowbit in the Ptdceescp 

Statu? Rff^iater i-i cltirEd. 

CU - CLfrif th* Interrupt diuble bil- The Interrupt disable bit in 
the ProcesBDT StatuE Heglsler is cleared, allowing interrnrta to 
Dccir. 

3S1 - SEt thi Intern^ Diublv bit. The InterriflBt di«alile bit in the 
ProceMor Stilus re^istBr is est to 1^ causing ali interrtitrts to be 
rridsMed (diMblcdJ until Xt\a Interrupt diuble bit la dearsd with i 
CU, 

DBX -Dtcrement thr X-rtg- Th* value contairwd in ths K-rto is 
decreased by 1. I* the resulting value in the X-reg is lerc, the Zero 
bit is Sit in the P. I* 11 is not zerOf the aero bit is cleared. If 
the resulting value in the X-rej has the high-order bi-l mt th» 
Negative bit in the Prcce ssor Status Register is set. Dthervise the 
NegativP bit will be clpared. Not* thil regislsr viIubeo* 8-127 will 
have a dear high-order bit and values of 12a-255 will have the bit 
ut. 



XKY -DEcrement the Y^reg. The value o* the Y-reg is decreased by 1. 
The ZePD and Negative bits are affected as with the DEX instructicin. 

IHX- INcrement the X-reg. The value of the X-reg is increased b^ i. 
TKe Zero and Negative bits are affected as with the DEX instruction. 

IHY - Increment the Y-reg. The value of the ¥-reg is increased by I . 
The Zero an Negative bits are affected as with the DEX instrLiciian. 
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HtBKiry accHsing instructLone 



INC -INCrement memopy. The value of a hyte located in memory is 
incrBiSfd by t. Ttte laro and NegaliY* bits ire **+er:tert »swith th^ 

DE:; Instruction. Only 2Pi ZP^ ABSi ABStX mcdes are valid- 

DBC ' DECrement cnenidry. The value ot a byte located in jnernory is 
decreased by 1. The same ccmments as apply for INC. 

LDA - LoaD the A-reg. The contents o* a memory locitim is 
trinsfprred to the A-reg. The Zero and Negative Bits are atfectefl as 

withthf TAX inetmctiDO. Vilid idbre asir»g modes ars: Imn*diate; ZP; 
IP,X; AJjtolute; Absolute,X; Absolirte^Y; nnc1ipect,X); Qfidirect,Y) 

LDI - LoaD tl>e X-r*gj Thi contEnta of a m-emory location tE transfBrtfl 
to the X-reg. The lero and Negative bits are affected as with the TAX 
ins-tpuction. fi.bs, ZP and ZPtY addressing modes are valid. 

LDY - LnaD the Y-reg. The contents of a memory lotaticm is 
transferred to the V-reQ. The Zerc and Negative bits ape af-fected as 
with the TAX instruction. Abs, IPard ZPtXaddPESsing modes are 
valid. 

STA - STore th-e A-reg^ The contents of the A^reg is transferred to a 
memory location. No registers or status bits are affected. Valid 
dddr§^^ng mod^a an: ZP; ZPpI; Absolute; AbsoluterX; AbuMciY; 
llndirect^j llndirectiY) 

STX - STore tJjs K-regj The cortinls o+ the X-rcg are transferred to a 
memory location. No status bits or registers are affected. Abst ZP 
and ZPhV addressing mraJes are valid. 



BTY - STore the V-reg- The cortents of the Y-reg are transferred to a 
memopy location. No status bits or pegisters are a-ffected. Abs, ZP 
and ZPpX addressing modes ar* valid. 
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ConditLanal Brandi Ins-truc-tiom 



DK - Branch Carry Clear. The- progrim counJer will bo Frif>dified by the 
Amoun-t Dt the specified displacement i^ and only i-t the C^rry Dlt iS 
clear {^i). forvira branches mi-/ occur i^ to i2S hytes trom Ih-e 
addr&is 6f ihe firsl byte -FDllQW^ng ths branch instructitjn, BicKwarfl 
branches may qccut ud ta I 27 bytes troin the sime addresi. Md crther 
registers other than t^e PC are a-ffected. Only Relative iddres^ing 
inDd? 1^ valid. 

BCS - Brarxh Carry Set, The program counter will be iriodLfiecl- by the 
ainoum of Ihe sp^ci-Jisd di^plactrrenT if ind only H the Carry bit 15 
set (Ih Same commpnts as fcir "the BCC inslrucluir. 

ESQ - Brarich ECluil. Tht prcqram counter will be TiadLfiefl Qy the 
amount of the soecified dispia cement ii and only i-f tha Zero bit is 
5ftt fl). Same commflnts a (op W* BCC inslfijcliofi. 

BNB - Brarch Hoi Equah Tnt prograni cDuntpr will be mcdLfied by the 
dmoiirrt oi iiie -^DeLjiieti Oi^ldUPmEnt li and only H the liro bit i« 

dsar (fti. Same commpnits as *or the BCC instruction, 

BHl -Branch Minus. The prcj9ra.n1 courTer will be moOifird by thf 
dmoLint of th« -specified displacement i-f and only H tha Minus bit is 

set (11. Same comments as -for "the BCC inst'uctiDn- 

BPL - Branch Plus. The program countar will tie modified by thp amount 
of -the specified dLspld.i:ein«nt 1^ and only i( the Hinus bit is dear 
i^i. Same conimentB as for the SCC instruction, 

BVC - BPiwh oVepHow Clfl-ip. The prograrn counlBP will bw modifieb by 

the amount of the specified disp^ateinent if and only i# the Overflow 
bit is clear (9). Same commenta as for the BCC instruction.. 



BVS - Branch oVertlow Set. The program courier will be modified by 
the amount of the specifie-d displacement 1* and only irf the OyeHlnw 
fill IS is\ (Dl Saine cammtnt^ a^ for th? ULC insiructiDni 
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JuBfi inatructiDni 

JHP - Jump. The PC is loaded with the specified addretSj causing a 
change in the -flov' of the program. Both Absolute >nd Indirect 

iddrfsiing noAa^ arf valid. 

JBR - Jump *o SubRouiine. The PC is hrsi inqruiiented by ?, The new 
PC ii then stored on the ttac^c. The ?CH is stored in the stack 
locailon addressed by the Stack Poirvter. The Stdck Pointer is 
Ctcrrmented and th« PCL is tKpn stared in the r^w stack locition a 
addnsBed by the SP. The SP is decretrented a second time and the 
address specified by the JSR instruction is loaded into the PCp 
causing a^np tothp cp«ci-litd tufiroutint iDcaticn. Nclx that the 

address stored on the stailf 1$ rtot what might be expected. The 
address is of the third byte of the JSR instructicrLp not the address 
Dt thi rmt wquantiil intlruclion atter the JSR. The RT3 
instructioni whi^ cauaes areturn from the subroutinei compensates 
■for this anomaly. Generally* tiie casual programmer needn't vorry 
^bovt the nie^anitf of staC^(?FeratiQns a£ loncj as she always has a 
RTS for every JSR. Howeverp advanced machine language prcgremmers sre 
-fond of direct sta^ manipulation techniQuea^ especially lor paiismg 
arguments to subroutines. 

RTE - RpTcim from BiiirEHjhne. The StacK Pc3int»r i^ first intr^inpntEd. 
The PCL is loaded from the stack address pointed to by thi StacV 
Pointer. The SF is then incremented again and the PCH is loaded from 
the -^lack. Tht PC is increnkenlid to compvnsatt for thi JSF< op«ratlon 

cf putting the address of Ihe third byte of the JSR on the stacK 
instead of the address of the next instruction. Now the PC has the 

atfdrtsB of the instruftiDnLmmediitely fDllowtng tJie mcit recent JSR 
in&lructiori. The prograin flow is thus ratLirned to the mainhne 
program front the si^routine. 



HTl - HeTum from Interrupt. This instruction reverses the process 
vjhicti occurs when an mtspfupl kcups. Thp- PPKesaw StaloiRegitter 
is retrieved from ttii stach where the interrupt caused it to be 
stored. The PCH and PCL are then reloaded trom the stack where they 
^DD were ctoretl ac apart of tFiP &5ft2's intErThtpt proc^^^tng. Tho 

return to the point d* interruption is thus complete, with the 
Procflssar Status Register having the sane value il had at the time gf 
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intfrruption. 

sue - BRftaK. Interrupt procsasing i» c*u=acJ to occur. The dddrtss of 
the nsKt bytt following thsBRKirwtructionisEaved on Ihs BticK. 
The Breik bii cs turwb cjn in the Pf^iSHor Status Rtgister which la 
then tavpit on th# itacK. Thr PC it loaded witfi th* adflres? founfl at 
memory Incaticsn *FFFE and »FFFF. 



SUCK Puih ( Pidl Irwmjctiorw 

PHA- Push the A-PEg. -nit A-rag in stored anihe bUcK at We addPBSE 
pointed to by the SP. The SP ii thtn decremanled. All PHA's should 
gonepally be mitctied witu i fallcwing plA. 

PLA - Pult the A-rtg- The EP is infrtmentftd, Iheti tr* A-refl ia loaded 
from thi stscK location pointed to by the new vilue of the SP, 

PHP -PuBHthftP-reg. The Ppqmssot Status register is pushed ontP 
the fiticK in the Bama fishiop the A-reg is with the PHA. 

PLP - PulL ^P P-peg- The Pr«es5QP SUtus regi&tap is puUafl o« 
the Bt*ck in the sane fashion tha A-refl ib with the PLA inatruction. 



PwudD-op Invtructiont 

BYT This ts not rpaUy an infitrjctipr in the instructior ^1 ot the 
i5ft2. It 11 an inatructiQP which The AsMinb^er retogniieB *nd 
intapprels to mem generate marfiirrt language data. Th» opprsnb field 
Dt thB BYT iPBtruClion can ejfpressseverfll types of data wTiich T^e 

Asaenblar wiU imflerstind. 

H thtHr5tfharict«ro+theBYTiia''t% thr following 
ftiaracters must be he. characters, i-e.fr-^,A-F. The A*«nMep -ill 
handle a string o4 he> charactera up to 8« characters in "^/^; J^; 
wU aenepate a daU str^mg -with two nybbles M h^lf byt^ - 4 brto> 
per byta, inserting a »8 in tfie high-order nybbt* of the high-oroer 
byte If there are in odd number of charactara specifi*d. 

If the first chiParter m" ". Thf Assembler •^l create a ^ 
data string with as many bytes as there are characters following the , 




The v^uas of t^e generated bytes will be the ASCII values af the 
^oPT^sponding chipaclaps. 

If the -First tharacier of the operand i^ a ruirber in the range 
-S-9f The AsBembler will interpret the operand as a deciirra] number and 

convept ;t ta itE binary eqmvaient. 

H the first character i-s nane of th« abovei the operarid will 
be assumed to be aji addrpss e>Lpre55iar which represBTits a two-byte 

addPf 53. Jt will computr thr address asscciated with 1h« eiipr^^siDn 
and generate the standard low-order first format two-byte address. 
Address ej^pressione are covpi^d fully in the chapter on writing 
Assembly langua.ge ^irograins. 

BflU - EQUite. This pseudo-op doeenot generate any data which gets 
stored into memory by The Loader. It is an instruction to The 
Assembler to set the Location Counter and to cause the label in toe 
label field to be assigned to the Addr&» whi^^h isei^pressed in the 

operand field. 



Shift Inctructiont 



ASL - AnthiFiBtic Shift Left. The contents of the A-reg or of i nsemory 
location are shifted one bit ^sition to the left. The Ipw-order bit 
pQSitiDn is -Forced to value zero. Thie high-order bit is lifted intg 
the Carry bit. The Negative bit is set if the bit shifted into the 
high-order hit position is a 1. Itisdeaped if i1 is i ?ero. The 
lero bit is set if the resulting value of the lifted byte is zero, 
cleared if it is not. 

As aneiiainote, it the A-reg has the value ICC (lieBllftflh 
after the "ASL A" instruction has been eirecuted, it will have thp 
value *9f! ( 1661 IM* ) and the carry bit will be set. If the A-reg 
has the value Of I5F leifli till Mhe "A5L A" vill cause it to become 

aBB Mflll ni4 Wrd the carry bit will be clear. Note thiat each left 
shift causes the A-reg to double in value a^ long as th« high order 

bit 1^ n?t i cne before ttie sh:ft. Shifting Ipft is a CDnviement way 

of mirltiplying a value b/ two. Using ASL in E^Dmbinationv^th ROLf a 
muitiple precision shift may be effected. See the desdriution o4 *he 
ROL instnictiDn- Valid addressLng modes are: Accunulatar; ZP ; lP,yi ; 
ABS i ABG.X. 
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HOL - HOtflte- Left. Ttip A-r-eg or a byte ir rTiemory may be shitted Doa 
bil to the- IpH. Th( high-order bit gel* -shiHeB into Ihs Carry hit. 
TJ^e tnw-DrdBr bil relieves the previous- cantpnts qf ihe drry h[i. 
The E-ame addret^^ing modes 4.ppiy as for 1he A£L irrfitruction. 

A multiple prccisiDfT bit ^hift i^ □n» wher« a string of bytss 

ifi treatPd liKe one lcjr>9 bit pattern and ihe Bftifl cauwt the bi-te 
which camp out of the high-order positions of tpie byte get 5fii+ted 
into the Icw-orOerpositonDf ihenpxtbyte in the sequenct- Fop 
e-BinpIe: 



eiTSh 



ROLIT 



L[>Y tt3 


SHIFT 4 BITS 


LDX tt4 


THRU 5 BYTES 


^SL 3TP,Tii 


filGKT-rtOST BYTE 


DEX 




ROL STRpX 




DEt 




BPL ROLIT 


ALL BYTES ? 


DEV 




BPL eiTSH 


ikLi eiTS ? 



Ttiis routinff v-roul^ cause the string of five bytps at STR In be 
Ipfi shifted tour bite. Each execution o* the ROL shitts the contents 
of the Carry bit into the lavr order bit oi the byte bein^ shifted- 
The Cirry bit will contain tht bit WhlCh Wi5 shilled OUt Of Ihfi higti- 
order btt position, of the previous byte. The ASL jsused is the first 
shift iDEtructiDn tn -Force iero bi-ts into the low order positions of 
trte ioiiv-DTQer bytes. 



LSfi -Logjcfll Shift Right. The rofrtenta nf th* A-feg or rheirtory 
IcKBti-on specified 15 Ehif ted one bit pceiticin to the right. The low- 
order bit gets shittEfl into the Carry bit. The high-order bit 

position 1^ tcrcpd toitra. The Zero bit is set based upon the 

ppsiilting value of the shifted byte. The Negative BU 15 tariied to 
rero. The same abdre^sirig modes apply as tor the ASL instruction. 

ROR - Rotate Right, All bits in the rotated byte are shi-fteO one bit 
position to the right. Tnp Carry bit is shifte^d into the high-order 
bit position and the low-order bit position is shifted into the Carry 
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b[t. The same addressing modes *pp'/ ^^ '■^'' the ASL instruction. The 
LSR and POP ifistructions are the same as The ASL and ROL in^tructjoris 
e^cpfit they thitt bits in the aqgosite dirErtions. Note that i one- 
bit shi-ft right results in an etfective division by tvjo. 



Boalean arithmetic imtructmns 



AND' Logical AND. The A-reg is logicaS ANDed ^ith the specified data 
byte. The boolean AMD operation is performed between corresponding 
tJlt^ of th¥ iw-o Dytes. Each bit position of the pair of Qytes is 
operated on in dividual lyi the resialt of the operation repJacing the 
Lorrespandii^ bit in thfl A-reg. The rules of the AMD operattnn are: 
if the two bits being AJ^Ded a.re value i, the result 15 a i; if either 
hit is a e the result is a %. That ist C* AND i: = fl ; C& AND 9: = fr 
i [1 Ann 1] - L ; [1 AMD 8] "< @. Example: 



lieeieiB ne-mory 



leSftlflfte rievi J^-reg 

Only the bit positions which Eiad a 1 in both bytes ended up 
^th a 1 in the result. The AND instructioni^freqijently used to 
selectively clear individual bits while maintainng the status of the 
other bits an the byte. This is done by cre-ating a "masK-byte" which 
h&£ a ft in -every bit po-^ition which needs to be cleared (set to ^], 
and a 1 in all the other bit positions. The mask byte may be ir 
either the A-reg or the specified memory location but the result of 
th? pp^ratLon alw&y^ rEpi5»s the A-reg. 

This process works because a 9 AHDed with either a or a 1 
gives a d result while 3 1 ANDed w^th a 6 gives a # and ANDed with a 1 
^ive^ A 1. 

DRA - Logical OR. The A-reg anJ the spvci^ied raiemory location are 
log-tea! ORed togelherf the result replacing the A-reg. The boolean OR 

operationp liKe the AND operationp is a bit by bit operation. Each bit 
01 the A-reg is OPed v/ith the corresponding bit oi the byte in memory 
by tfie toUowuvg rules If either bt( is a 1* the result ts a i. If 
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both bJtE are Bi me rtsultiaS. ThitiSf CI Ofl 1] = 1 
1 J Ce OB 1 J - 1 1 fl OR e ■ fl, Ei^ampl*: 



CI 0P«] 



DRA 



naaieie hemory 



The OflA i^ -ff-pquen-tly used -to seledavBly turn hits on (set to 
U. LiKe wilh the AND, i mafik must bt created which inditites thp 
desired bits to set and the bits to tte unaHerted, The QR masH must 
havB a bit on in the bil posilicf^s to bv sei ind oJf m the posiiione 
wtiich need to be niaintamett. This isoppcjsite a-f the AND masKi 
ThErfif t-bi1s mainlairied the status cguo. Here, fl-bits have that 
rp^ponsibility. A fl in the mask byte when DPed wilh a 1 gives a 1 and 

when Ofted with a a give a e. And a i in tht ma^K byte always results 
in a I result. El OR i] = 1; f 1 or *) = 1- Valid addressing modes are 
the fia^e as *or the AND irretrtxtior, 

BDH - E>! elusive OR. The corrlsnts of the specified memory bytft are 
EOPed with the contents [>f the A-reg,i rfiplaciTig Ihe A-r^g with the 
result. Lil*E the AHD and OR instructiunsf this is a bit oriented 
intlruc-ticn. The rules o* E>icluaivE-Oring are; The result will have 
a 1 in any bit position fov which only one d^ the twg tylffS being 
EORcd have a one. AH other bit positions oi the result will hflve a 
e. ti.e. [1 EORfl]- 1; CI EOR i] = a; Cfr EOP 83 ^ ft; [0 EQH H ^ t). 
E>:ftmple' 



EGR 



i^iaiiee 



M emery 
Pt-req 



9J10Glie New A-reg 

The EOR instrudion is usB^ul 4or inverting bits. A 1 in any 
mask btt position will cause tho corresporHjjnq [jit in th^ rq^l-t to 
have the opposite value as that o* the cormtponfling bit in the ob*ct 
byte. A 1 ae+ore EORing will rf suit in a 4 i+ttr and vi« versa. A 

«ro in ths mjsKbyte will cause the corresponding bit in the ob^eirt 
bytt to go uTi'noJest^d. 
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BIT - BIT test, Th* A-reg is logically ANDefl with the contents ot the 

specified iTh?ir^p>'y Imlicn. The ^er^^lag js srt il the result of th« 

operation gives a cero result. The Negative bit is set if the hig[^ 
order bit ot th« memory locaticm 15 set. The Overflow bit is set li 
the second-highest-order bjt 1 the 6-bit ) Qf the memory iKition is 
set. The Negative and Overt low bits are cleared if the 7-bLt arfcd i-bit 
oi the menhsry lora.1i[yi are flear, Th^ A-rsg is not aff^fUd by the 
e>:ecLrti-ODn of this i-nstruction. 

This instruction is very useful for testing individual bits of 

bytes inmemory. The A-reg lEloafled l^1th a masW which his ones in 

the tilt positiGrs to be tested and ?eros in the rest. If any of tJie 
memory byte's bita in the tested positions are on the result of ttie 
AWDing operation wiU be rvan-zero. Note that the inasK may be either 
in memopy or in the A-reg for the test to worH. The Negative and 
Overflow bits are set based only upon the bit con-Figuration of the 
memory byte however, EhampJa-: 



MASK 



OK 



SM *ei 


LDA 


r^sK 


BIT 


IJALI 


BhJ 


BIT? 


eys 


E1T6 


BT^E 


B1TI0R2 


EQU 


3 



The valueofthebyte assignedto label MABKisiSi. The 1- 
bit and the 2-bii an on and ill others ire off. The BIT instpurtion 

ANDs the contents of the A-re-g, *ft6t with the byte at VALl and the 
result will be norr-jero only if either the t-bit or tiie 2-bit 0+ VALl 
IS a one. H VALl has itE high-Drder bit m, Iha program will branch 
to BIT7. If the 6'bit is on in VALl tTie program will branch to BlTfi. 
H either bit-2 OP bH-t *re on, the branch to BITIOR? will be taken. 

The " a " is used in the last statement of the program. It 
has a fipetial significance to The 

Assembler. Used in the operand fteld 0+ ari instructinri it is liKe a 
symbolic laibel except it rtferffrtes the current value o-f the Location 
CnjTter. Hen, it peHorms the finiction of assigning the value Qt the 
Locition Counter to the label "OK". 
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ArithMttk itttiructiDnB 



ADC -ADA withCarry. Additionls ppr-forniEd with the A-ptgt tht 
sped+iPd mf mony locahm and the Carry bit. ( A-r*g ) ? ^ A^rpg k + [ 
Bddr ) -<- ( zirry i. The (..J is need ticr^ In mean ''the cantsni^ 
Df". The rpBult fflpla«5 theA-reg, The mode o+ flr»lhm*1ic is 

detErmirwd bf the sUtusof the Dicint4l mad? bit at the timo trie 
LnslruclLon ifiexflcuted. T+ «p1, thp mode of addition is the Decimal 
(■ioiIe. H d^dr, the mtjde ii binLry* Valid addressing moles are thae 
5irfie as ^i:r tht LDA inslroctian. 

Binary adititian i& quite simple. Iti^jj^i lihe decimal 
Addition e:icept -the highest number you have to worr-y about is 1. T*it 

rulpsQ* -idditionire: 



1 4 I IE ] 



^2 in decimal > 



The- third eKampls is the only one which is di-fferent frnin 
decimal addition. When we add s pair of binary num&ers with more than 
one bit apiacer we prcc^^d from right lo left Just IlKe dBcimal 
addition. We add the two bits togelher and it the result is greatpr 
than 1 we have tocarry 1. So, ll*li=iie. Domg this addition 
ont sttp at ft timsi taking the rightmost ijitsi 1 and it flr>d iflding 
them tty the above rule^f we gee that the an5v;er is Ifti or 6 wrth a 
carry d i, Htxi we add the ne!<t pair o* bits plus the carry. 1 4 1 
+ i = tl + l> ♦ 1 = ifl H = 11_ Thflt^ 4 1 with a c^rr/ of I. KotB 
that 1 + i * 1 ' 3 in decimal and 1 ♦ i • 1 = I i in binary which i s 
the binary souivaLent of 3 dfl-fimaL The most you have to remeriber in 
binary addition of two numbers ise*e = fl; ft+l=i; 1*1- 18 
(a carry 1> ; 1 t 1 ♦ i = U (1 carry t). Ths ABC instruction does 

Itiit biriary addition u^opk tor you, so you might not need to Know it- 
On tile other hand, you probably will when you go in debug vour 
Galactic Gobbler Game, Bo vou ntight jist a^ well leam it noh. 

When in Deamat modei thp fi'5^2 er.pe^-t^ the data Ltia adding 
to be in "binary- EinJed decimal" format. This is yet another data 
format. Tn 6C&. the eight bits of a byte are interpreted to be two 
tour tit deHmjlcijgitSi Eith f OUT bit digit may f>*v? the hexadecimal 
values of ft-9. If there is some Dthe-r bit configuation in the range 



of A-F in Eitherhalf of the bytes being added, th« results will be 
ixuneaning^uh When the ADC ks eKetijted in Decimal modep the two low- 
order digitsarr AEided anti 4ny d^cim^l Lar^ry ia addsd together with 
the two high-order digits. The carry -bit will be set if there is a 
dedmal rarry fram the iddttiaiof ^he high-^rder digits. 

U is standard prDc^dure to dear the carry bit before using 
the ADC instruction because the Carry bit IB added into the result. 
Thit ic a nicp featLre when you are doing multiple preciwcn addition 
such as adding two 32 bit numbers together. The carry bit is the 
needed communication between the successive bytes of the addition. 

Example of 32 tiit mullipl* precision addition: 



4 BYTE iftDDITION 




LDX 113 
CLC 

NE>rT LDA lAmi ,)< 

ADC >JAL2,X 

STA '^LS^X 
DEX 

BPL fi£Xr 



SBC -SuBtract with Carry, The specified byte iri mEmorv ind the 

inverse- ot the Carry bit are subtracted from the A-regi replacing the 
A-reg witli the resUt, That is, (A-reg) - (A-reg) - 1addr> - Cl - 
(Carry)], The Carry bit is wt if the contentE ot the A-reg ire 
greater than or equal to the value beirg subtracted from it. The 
Carry bit is cleared if the value subtracted t5 less than the conterrts 
of the A-reg, In deciding whether the cnntents of the A-reg and the 
memory location are greater than or leasE than one another, the 659? 
interprets the vdu^s as ungigned integers in the range of fl-255. 

The carry bit is liKe an inverted ttornowr If a BorfOV iS 
required, the Carry bit is &. if no borrnw is requiredi the Carry is 
1. TTie Negative arrt lero bits are Hi based on the result of the 
subtraction. The Overtlow bit is set if "two's complement overflow" 
ocurred. Valid addressing modes are the same as tor the LDA 
instruction. 

The rtormaL subtraction procedure is to s»t the Carry bit before 
the SBC IS e>:pcuted. Using the SBC to compare two values requires 

testing the Minus bit after the subtraction is complete. 

H the desire is to branch to PHGA if the contents o* VALl 
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iPE less than th« contftntia-t VAL2 the fol^owinq prograEn wtxjLd b« 
used; 

SEC 

S8C VAL2 
&M PRGA 
OK EQU 3 



ifi not Ipss than -4. Thf ovsr-Tlow bil was sel by the SBC. The branch 
i« taUr tD CHKHl where the Negative bit is tested, li Ujjn beciusc 
thp vAlup in t^ic A-reg is greater than ill. It i5 130. So the branch 
is not taken to PRGA. It wcrltei 



CoBCur* Tnclnictiani. 



The abav« rnutine workc for unsignEd numbers. H i earn piH.Qrjr 
Ie being mide of numbers whjch m ay have rKgative values^ a morn 
CQitipleif routins must be used. The possibility oi "negative cverflDw'' 
sjiisti when fiubtrictiriQ nunbers which are intended io represent values 

in th» range ot S to 127, -1 to -128. 1* we try tn sijitrict 18 ^rom - 
I24t the result would be -134. This is out of the range of negative 
numbers. The £367 lets ui Know that if this was a signrd apentiDni 

the result had "relative oveHlow". This is don* by Setting the 
OverHDW bit in the Proce^^Dr Status ^egistar. The value which ends 
up in the A-f*9 Is 1^3 (J5A-1341 in the abovp eitamplp. The unsigned 
equivaltrvt of th«-]Z4i& 132 \2i£-i2^). And 132 - 16 - 122. This 
positive result gives i false indication d-F 4he relative magniiude of 
the two signed rumbers. When working with -signeil mimbers tfto 
following technique is nccBEsary tc maKe accurate CDntpansons of 
magnitude: 






SEC 




LOA VALl 




SBC WfiLZ 




BVJS CHKHl 




BMJ PftCA 




BPL OK 


CkkKl 


BPL PflGA 


OK 


EQJ a 



Positive overflow can Mtur the same wiy. S^ipose VALl has 
the valuB of 126 and VAL2 has the value of -4. The intention of the 
above- program i« to branch to PRGA if VALl is Ivss than VAL2. 126 - 
M) ■ 13fl, 13ft isoutaHhi rirgp of signed mmdera i9-127). 
Positive over-flov* occured. The 65fl? tells us this in the samv way, by 
setting the Overflow bit. Does the prograni vark 4or this case' il& 



CMP - CoKPire. The magnitude of th^ specif iH memory locahon is 
compared with the magmtjde of the A-reg. Ttie Zero and Negative bita 
are sel as though a SBC had occurred. The A^reg is not nvodifced by 
this instruction. The carry bit need ncl b& pre-set dp cleared before 
e:fecuting the inEtruction. The carry bit is set if the compare finds 
that the A-reQ is greater than the vaJije of the contents of the memory 
locfltiLjn. The Overflew bit is not affected by this instruction. It 
IS therefore not possible tu use the CMP to maKe magnitude 
compaMstons ai signed numbers. The description cf the SBC 
instruction iUustrates the le^nique for accamplishina IhiSi Valid 

addressing tiiGdes are th? same a^ for the LDA instruction, 

CPX - CoffiPare the X-reg. The X-r^g Is compared to thr contsnts of a 
specified memory location. Ttiis irstruction furctjonc exactly liKe 
the CHPin5tPLiCtiDnfti(ce[yt1hereoisterbeingcGmparedis the X-neg. 
The valid addressing modes are Absolute) Zero Page arkd Immediate. 

CPV - Compare the Y-f^g. The Y-™g i% tompared with thp conlantfi at 
the specified memory location. This instruction fuictionH exactly 
liKe- the CMP and C?X instructions. Addressing jnodes are the same as 
CPlf. 



Inpotent Imtructiani 



HOP - NO OPepatian. The amazing HOP instnuttipn does afisolv/tely 
nothing. 11 causes the 4562 to spin its electronic wheels for a few 
micrDMCondB. it tiJttfi i* one byte of memory. 
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Th» Toolm 

There -are -five QDE-twar« -tool^ which m^k? up the stARdird Jtttp 
The Editor X5 used to create, modify and save i-ssBiiibLy UTiguACfG 
pra^r&mslD c&SHlte or di94<ett«. II perfarms »H4in ecrcir checking 
^unctiDHE as well. The Assemblsr reads the a^Mmbly programs whkh 
wpre creitBd with The Editor and Th» Decoder ar>d prodLices a madiine 
tAngudQE prcgra.!? U$tinQ ttixl machine l&nguige load modul^^ on c»Bf tie 
or diskette- The Loader r«idB the load modules -froiFi iias^etie or 
disKptte into memory where they may be PUNp single-stepped or SAVEd. 
The HQnit[>r cin g ingle -Etp p thrcugh any inadtine lan^u^ge progranti 
dispjiyirkg the various registers ^nd status bits dt every step. !t 
also allows the essy e>[aniuiatLar and madi-fication o-f mEinory locattons- 

T^e Ppr^ode'' dcMS ihff opposite of The j^s5*ni&itr. it reads mathine 

languagE programs -from the computer's inemory and converts them into 
itSDmbiy language whii:h CaA then be saved to cdssette or d^sltette 4or 
rfl-sntry into The Editor and The Assembler, Listings of tt^e a-ssembly 
language pmgraii' ire also printed Id the screen and/or the rrirter. 

Uith th« ej^tBndeb'fei'turc version sMhe kit (^P9 eifchAngc offer At 
end of boDH)i the Edtior and the Assembler havp been combined into one 
program* ABHEDT. This version requires a mimmjiii oi 3K of e:<pansian 

menkory but tsea^i^r to u^. 



FlTVl Steps 

BfrfOTfl ittemptingtcgSe any oUhe software toolst bscWjp 
copies should be made and (he uriginal tucKed away *or sa-fe Keeping. 
Safe keening for any magnetic media means in a cool dry place aw-ay 
■from 50Lint*s o^ migwtic tlu« such as TV Mts* LaudspeatePBr 
transformers p power supply^* exploding nuclear weapons etc. 

To back up your programs I load them one at a time using the 
usual procedure: LOAD kskxx^t lor LOAD xxx^^sxfS for (Jisketlef where 
sixhKhx IS the program name. The names of the pi^ograins which you 
should find on the distributed medi-a are: EDlTDRi ASHBLRi lOaDERf 
HONlTOfi, DECODER and A5MPRT. Mter loading each programr fiavfl it 
either on c-assette or diskette as you please. Againp the us-uaE 
procedure is followed: SAVE 'y^a^n or SAVE K)ixxV]^pfL. Be careful ntit 
■to save the progirairi ont^ the cassette /-du JLst read it in from as you 
win no dmiht write over the nE>it program on the tape. It would be a 




good idea to save each program on its oi^n cassette tf you don't have a 
disk system. This will CLrt down on the time li takes to find and load 
the programs when you use t^em. 

H youejiiperience trouble loading anv of the programst be su^ 
^ou have spelled the name riqhi and that the tape i-s ifi the proper 
position. H LOAD EPRO}?B prevent you -fro"! loi-ding the pnjgrain or the 
program jjst doesn't seem to be on the media at all and you are sure 

your machinv^ a^e in good wortung order-i ycsu should return the media 

to French Silk for a replace ment. You have thirty days in ^*rfiich to 
find out if you have a prablem and to return the faulty media. A 

replacement huill tie rrade at no charge. 

TlteBditar 

Load The Bditcr in the sarrie way you did when you made your 
backup copy. Once it is loaded and Hh^ ^cr^en display ^ayS READY, 
type !4UK. The screen will change colors and the copyright message 
willappeaTi foMcwed by the prompt* "NAX?". This is the only time 
this prampt appe^r^. You are betng a^k^d ho^ large an A^»mbly 
language program segment will you b* wanting ta create or kiad. It is 
only impcv^tant to answer with a number at least one greater than the 
largfr^t number Gf statements you expect to have in any »gnient. If 
you have a 5\< VIC you can always answer 96. This means you will not 
be allowed to create a program segment, larger than S9 stateiErents. 

That 15 about the most you can ^et into 1he mimmum VIC anyway. If 
you have some memory E>ipansionp you can figure ongetting about an 
^xtra 59 - IS statements per H ol expansion. Sop with an 8k e>!pander 
you can figire you can create and assemble a program segment af about 
5M statements. Later oop we will get into breaking large programs 
into smaller wori<able segment^- 

For novi, enter 98 regardless of how much expansion you have. 
Do thisby keying -Ve [Rr. Note that at all times in this te>rt we 
will use the TRJ" symbol to refer tn the RETURN K»y. 

You should now see "CPLDIH5" in the center of your screen and 
a '"^'' on the following line. You are being asked to select a choice 
frgm the menu of oplione* Brieflyr the options are^ C - crealBr P - 
pnnt, L - Load, D - Delete, ] - Insert, K - Modify, S - Save. iHote: 
with the Extended-S^eatures version of the kitp the additional menu 
option "i^" ftpr Aaaemblv appears- after the other editing optionali 

Birtce we are now going to create a program seg-ment you should 
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hey "C CR]". The screen should new clear and " ?" " Ehould appear on 
th* secondlintDfyou^ display. This is the pm^pl for entanng a 
line df a scurce prDgrani 9«gnient. It always appears in tfiB sam^ pUn 
onlhe screen. Thia i« the "e flit- window". When we get to modifying 
program &cgm»nt^ wv will see that hnee to be nodify^d will appe-ir in 
this 5An» edit- window. 

Grter the ^ollowirg assecrib]/ Urguage stateiriBfrf without hitting 
[ft]: 

LCHJE5U7iM 

Be 5jre to £eave a space after the Ubeli LDWp and- be^re 
*he mnemonic, EQU. Qb sure riql to leave any space hetwren the EQU and 
the operarfcd, 7fiflfl, H you made errorfi in Keying ihe ^tipv^ statement 
you may inove the cursor \o the error with the cursor contrul keys and 
CDTPKt it hy typing over the error or by using the [d»let?l and 
Cins#r1J t*yfi. Until CR] is hat, changes may he made at will. Each 
statement entered in the edit-winflaw may he at most Si characlsr-s 
long. Thii is four complete 5cr»en lines. 

Once you have the stateirent keyed just as shown, hit CRD. You 
should see the atatement appear a few lines lower on the screen with 
tha Ime njmber 1 on the left and with i Bpacp between the EQ.U and IhB 
7i»a. Mot having to ksy the space betw^een the mnemonic and the 
operand is like an automatic tab feature and saves a KeystroWe. H 
can be contusing though^ p'pecidily if you ire usBd to other 
assembior/editcrs which require the BKtra WeyatrDKe. ^egarctleES, this 
IB the format nf tvery stalemert you will enter with The Editor. The 
lab?1 -Field is optional and if omittedp a single Epace mu^t preceed 
the mnemonic- The first space after the mnemonic signifies the 
beginning of the commEnts. In this example no rocnrnpots htvf iO«n 
errtered. 

Mow the edit-window *tiouLd be blank e>icept far the prompt 
(?"), 

li is time to enter the secoTHJ stateiPBnt of the program. Key the 
following: 

MSG BYT'lT WORKS 

T^e label field is "HSG". The nneirionic is the pseudo-opr 
'BYT", and the operand is "IT UFQRr?. This would uejn to be a 





ciontradiction o^ what was juet prsvioLMsly stated about the firs-t 
space starting "the cDrnments. It is. This is the only e^cepticir to 
the nila. When the -first charatter cf the operand field of a BYT 
instruction isa"'*', then tig comments are allowed and the entire 
fharacter string after the " ' " i« considered the operand. This 

Operand type n called i liter*), string. 

When the statement 15 entered correctly, hit [PL This 
statenient shou-lQ rvcw ippe^r a-Fter Gt&tement i on the screen. It is 
line * ? of the program being written. Th& edit-window is now open 
agaui. 

EntBi' 1he statement: 

S?GeQU£58SCRBEK 

Hit [R] wfien you've got it right. It ap^ared like the others 
down below the window, riqht^ It -should ha^e. How| the problem is: 

it 19 an inccrrvci stilementi H should have been; 

To fih it, we have to leave the mode of entering ne^u 

statements. This ie done by keying [R] with a blanK lirt» in th? edit- 

window. Do that now. You shturld »e a return of the original menu, 
-followed hy the ■ ? ". Tn tin a wrong Une it is necessary to choose 
menu apiion "M" for modity. Do that anO be eutb to hit [HI. 

Now ttie crompi, "Lilt^" should appear. This prompt is used for 
the Hi D, P and 1 options. It means which Lin» number (U and how 
many lines {«)< For ^e Mofjifyt the secoid number -shpuld 4.1wdV5 be a 
"l" since we canorly modify one hne at a time. Key:3,tcn}. The 
statement we ijst entered should now appear in the edit window- At 
this time it is possible to make any modificilion draired by using tJie 
cursor control Keysi the [insert] and [delete] keys and keying over 
any characters -^ich appear in the windtjw. Hove the cursor to the 5 
and key a 4. You can hit CP] now if it IpoKs like it should. There is 
no need to move the cursor to the end of the line fte-fore hitting tPD. 
Now the fiued version of line 3 shGuId havi replaced the erroneous 
one. The menu should have reappeared once again. Well use the "P" 
option to see the altered statement. 

The Print mi^dc option allows you I0 list your segment to the 
screen. You may start anywhere in the program and print in blacks of 



Intid* Tha VIC 



Pag*A-3 



InildtTlw VIC 



Pm^S-6 



tny siM. Key"P'[Hl. Vau will »■ thp already fimiliar "U*>" 
promp^H You *" frMng isked whsre do you want la begin Ijslmg tft* 
program anti how many lines do you want Ijated. We only have three 
lines ac far m it would be reaaonablP to Key 1,3 but -for the sake o* 
Bducatiant Wy 1,1 [R] inst^ti. if youdifl ttiatf y an will see W« 
tirel line was diapla/ed and the mtnu reappeared. Maw, it you Wy 
only [fl] the listing will cwtifiue with the np«t blocKof M lirws. It 
wLll print the same number of Jinas as ^ousp?tififlflti5-r time, i.e 
1. This is moat carviBnient wtien yog have a large program and wish to 
Mt a scr«*nfLdll ai a time- Ancweinng 1,1^ to the initial prompt will 
cause the tirst 15 lines to be flisplaved. And each additian^i time you 
hii rP3**tErthatyouwiJlgetif>othPrl5linE5. Hit [Ri ag^in and 

th¥ last Lint will appear. Note that it wis changed by yeur 
HcsdificationprocpsB a while back. I* you hit [R] any more, all you 
will get is the menu again- 

We want to continue adding morp statertisnts to our prognm but 
it would be a mistake in try to cortimje by re-enlPring the Cr^dte 
mode. That causes 1h* wtiole list ol entered eiatements to be era»d 
and the statBirient number io bie r&^et ^o 1. DO NOT TYPE A "C AT THIS 
TIME. Once the Creais mode has been abandoned to fix a statement or 
to Print the se^mBnt, new Etat^ments may be added only with the Insert 
option 

Thp "I" commandt will cause js to re-enter the statement-input 
ntQflp. Key 'T now to the Menu pponpt. Ue won't bother to tell you to 
hit CPl aHer each entry any more because you already know that it j? 
required. 

If you enlered -r-t tht "L,*!^" shajlrl be staring you jn the 
face again. Fw^ this mode, the right response is the Line after which 
you wi4h to insert new statements. The "«■ 15 how riiny hnes do yoj 
wish to insert. When all we want to da is tc corrtiniji adding to the 
entf 0+ the program (liHenowJ we enter the last line number 0+ the 
proqpam and th-e rvjmber I 13,1 in this cases. The number of lines to 
Be inserted is very important when ypu are inserting lines in the 
middle 0* the program. You could overwrite some of your program if 
you Pnl*p mans than you uy you will. You will have lines duplicated 
i-F you ente-r less. When addinri to the end. however- we can add as 
many as we want a^d only stKcify "i" without heaving any problems, 

Ydj should Bnter "3, r now and you will sse that the lines at 
the program i^j to and including the line L will be listed. And the 
edit-wirtdow prompt will be back waiting -for you to continue the 



entering of your program. When entering program lines the most common 
emv- is to sithsp -Corget to tnier a space Before the mneirifinic or to 
enter one after it. If you get stopped with an EHR message it is 
probably because you broke one of those riiles. 

ERR 1 means either an invalid mnemonic was entered cr mare 
than one space or no space immediately- preceded the mremonic. ERR 2 
means that either an addressing mode was used whidt is invalid for the 
mnemoniiror that a spsce wis entered immediately aftpr the mnsmonic- 

The *irsi three statements of the following program have 
aWady been entered. Now enter the remainder^ You may experience 
occasional delays of a »rond or two aft^r fntering ttie input ljn« 
before the prompt returns. Note tiiat "there is a Ift character input 
buffer whidi allows the fast typist to "get ahead". 




LCU 


EQU 76^9 


MSG 


fffl 'IT UORKS 


SPG 


EOU 648 SCREEN 


ENWiSG 


EGU a 


LEhffnSC 


EQLf ENDMSe-tlSG 


ENTRY 


LDY flLEWISG 




LD»^ ti«e3 




STA 3667? SCRN COLOR 




LDA tl9«22+4 




STA *-e 




LDft spe 




BTfl H 


LOOP 


LDA MSG-l.Y 




flWD il»BF 




Sift (9)jY 




DEY 




BNF LOOP 




RT3 RETURN 


LflST 


Efllt Ef^RY 



The RT5 may have caused you a problem. It takes no operandp 

so the "^RETURH" must be separated from the RTS by a space since it is 
a comment. 

Once you ^et all of these staiements entered, exit the entry 

iiHide the same way we leftthe Create modtr i-e. [R] an a Wank edit- 
window line. Now would be a good time to check the program for 
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]i tumt out there is i mietakp in ifie wiy Ihp program was 
written- Fop it to vorK tgrrettl/, atiten^nt 3 must bi mav«d aa ttiil 
ENDK5G*ollDwstnnwdiately iflar MS&, AJbo, an EQU LOW+LENMSGnPtda 
tDh«ii^5#rted JLntbtfcns-tatemen^i. 

To accGmpliflh these mcdifka-EiDn^ ygij need to first dftltte 
BtatsniBnl 4. You shculd have finished the insertidin pracsBB of 
crflitinj 1h* ibove wgiftflpt 6y hiHir^ Cfi] with a blank line. Ths menu 
should be on the- scresn now. Give it a "D" for dele-te. The- "Lrtt?" 
now mairbertipQndBtlto with a M,!". This is to delete cx» line at 
line njniber 4, DncE it itdore, tfie sienj will reapci^ar. 

Nov to pjtit backwhere it beJon^fii you will need to bo an 
Insert. You should know hcjw to do this now. You will want 1o insert 
me line i*tffr line Z. Whrn you g#1 the ■* ?"", re-key the ENDMSG 

Btat*iiiert follovftd by TR], To get cut of irtsert mode hit LRl with a 
blank edit- window. 

One more thing tn do. Intsrt t^e "EQLT LOW" line iHtr line 5. 
How, PB-l[5t the entire program with the P option. H should loaK littB 
Ihisr 




LDU 


EQU 


7609 


KSQ 


BYT 


■IT UORKS 


ENDMSC 


EQU 


i 


SPG 


EOU 


646 SCREEN 


LEmSC 


EGU 


ENW1S&-MSG 




Enu 


LftJ*LENMSG 


FhfTRV 


LDy 


BLENM5G 




LDf\ 


ttfflB 




STA 


3AQ79 SCRW 




LDfl 


li**22*4 




STA 


^-0 




L[»A 


SPB 




STA 


H 


LOOP 


LCkA 


MSG-l^Y 




/V^D 


tl«SF 




STA 


<fl),T 




DEY 






aNE 


LOOP 




RTS 


RETum 


LAST 


EQU 


ENTRY 



COLOR 




If everything loohs righti ^cu cm now save the segment you 
jjst created- If there are Brforst uu th« rrodify or insert or delete 
commanfle to correct the problem befor* pPDceeding. 

If ycHj have a cassettB verciDTi of the software toolEi place a 
bUnk cassette in tiie recorder and mak? sure it la rewound. Give the 

nienu An '5" tor Save. If you hive the dJBl«tte versicmi put any 

diskette with a little space left on it in the drive and key the "S" . 
You will be asked the "hAHf?" which you wiEh to aasignto the file 
which you n^ about to createi If ycu have a disKr you muit give it a 
runne. With cassette r the name is reccmmended but optioml. Res-pond 
with the name "TEBT. 

The Eource program segcnant will now be Eave-d. Uith cassette, 
you will be asKed if the redorder is "OFF?" before telling you to 

"PRESSPLAY AND HECORDV You need only hit return is this is just a 
pause to insure the recorder was not left on from the last input. 

Once the recording is finishedp the menu will reappear. Nov 
the fir*st S-Bssion *ith The Editor is nuer. To proceed with the ntxt 
step* assembling the program with The Assembler, either select the "A" 
option of the menu if you are using the extended-feature version or 
prs-SE the STOP and the RG570HB h^ys simultaneDit^ly ^nd proceed to the 
rwttt chapter. 
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Ttw AMB«bl#r'ThtppogriniB#gmfntstpii1a[)withThBBditDrfieBri to 
be Irarwlattd into *rtuil muhint language. This is tf» functiofi o* 
Tbt AaMfnbl#p» It can read in And transUie anv number of coraeGitive 
iOKTcw (asstmbl/ Iingu4g«} iegmanH, Fdp Mch icgmvnl Peafl. H will 
generate a reprirvt of the oncjinal sarct atatamftntH, each fallowed by 
ita michif* language equivalervt. H wiU p^inl the maOiine languagi 
in BiihirheKadsdmalDTjecimal. It ftlHO optiDrull^ prcducifi 4n 
Dbjct Imachiiw Unguagt) nrtput fiJe which The Loader can th*n load 
into thf specified memory locaiion* of the computer. Wth ttie 
extended-features venion o* the kji, IPw AsHBiblfris t pirl of 
ASMEin, the Abbe m bier/Editor comtiinalion. The only fuictional 
dHfrrtnce with ASflBLR antf the a*Mm[>l*r poHioncrf ASHEflT ie that 
direct POiEing Qf the gentraled machine langusge into memory ia in 
optjon Df ABMEDT and it is not possible wit^i ASHBLR. This feature, 
when UHdmiKttiotatteiiiottQPOKE michint linguifle intc the portion 
of memory which is uied by the AEMEDT program itwlf, « thii will 
ciLBS hH destructlanolASMEDT. The POia optior is elected bv 
arwwtnng "Y" Id the -POKK?" prompt, 

^°^' ^^^ ^*''* *■* *^ vereion of The'AsiembLer uTclucJed on 
the riiitrlbutior media. The Hcond version, ASHPRT* outputi to the 
printer rather- than the Kr>en» To lou] Tht Autmblfr, hav4 eittitr 1h« 
cifisette or diskette with the saved copy of ASKBLH far ASMPPT> in the 
ippropridte fl*viM (pororder a^disit drive) and key "LOAD ABHHlff" or 
LOAD ASMBLP^e- it you have ^ diMette. When tha READY. 4pp*ar3 on 
the icreen, key 'RUH'. 

You will new gel the lArnt -KAI?- quvition n with The editor. 
Here, again, you ire being ashed for- the maximum segment 4tie in 
number of assembly language ■tataminti. Reipond with '98 [fij". 

The ntift prompt wiilb* "D/H?". Doyouwiah to lee the 
machine language in decimal or he>raded>iil? If youhey "D CRJ", the 
result will be decimal- tHherwiw, any respome Including [R] wiU 
cause hex output. Key i "H CP^' this time. 

Now theproeipt should he "NAME?". CHve it the name erf the 
iOi/*n MQment you cp**terf with The Bditor. In the previoui chapter 
we created a snrce fUe named "TEBT, Ttiit U wtiit you Ehould enlfr 
now. WithcasMtte, if youhit jui-t [ft], thefirst-filefomtf onthe 
caK»tti i*m be ugH. If the pecorOtr wti off, you i-^U get the 
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"PRESS PLAY ON TAPE" messaije. Doso. 

Now the -file ihould be lodding. A]thouci»^ thii it k t^«ro-fuf c 
AafenblePf this is the only time the -file actually has to be read into 
the computer. You can bt sire the file has beeri fnrid by listening to 
ttie recorde-r. There will be i Bliflht pause every feu/ tecond^ as the 
tile is being prcrecEed. Somtinesi if cassette recorders are nat in 
the beet dI health, files created with one pragrain do not load very 
well with another progrem. File -ere ition h&s less built-in fault 
prevention than does program-creation and so files are more prone to 
Loa-d errors. The usuaJ ayviptacn af thi« problem with The Assembler ii 
a "STRIHG TOO LONG" trror. You can try to load it afliin or ycu might 
have ta re'-create i-t with The Editor. If it is a persislent probJeni 
you might be well Advised to have your recorder tu-wd up. 

When the file haa been eucce»tiiily loadedi the ne^^t prompt 
appears. "OliTN?" is requesting a namr to be assigned to the machine 
lan^a^e aotput f ila. Hyoudan'tMvhCacraate am at thit tirht 
you must hit CRD inly. Do that now. 

Now the program wiJL start to be listed cx> the screen. You 
thduld see the first ten lines of the program which u/as created with 
The Editor. After each lint of source should be a iine with the line 
numfivr on the lef ti folloiwed hy the address of where the machine 
larvguage will end upi tollowaa by the actual nichine language 
translA-tim of the preceeding assembly language statement. 

Ten such two-hn^ statements will be ^allowed by t single " ? 
"i The Asiembler pauses every L4 itatements tolGt you vww the 
screen and to tell it i^^in you are ready to have it continue. To get 
the next bitch of ift statements it is necessary to Key any^ingbut ' 
/ ". A' J '■ will cause the assemt>ly to bf pr*ifi*tijr?ly ended nnd a 
return to the point of asKirg "E/H?". Cfllisthe nCK'nial response. 
Kty Vnti now. 

The rest of tht program should now be assemblid and listed. 
It vill be follQwed by the "ENQ?" prompt, if you have all you need 
from Thi AswmOler you n»iy want lo terminate tbe program by limply 
pressirtg RUN and RESTORS simuUaneously. You may want to assemble 
mother program segment at this -Time In which case hitting [H] will 
wurh. You may also re-acumble the same segment now without hav^ to 
re-load the source tile. That is what we will do now. Key CR] to the 
-BMD?- prompt. 

Uesh^Tuldbi bacK at the "D/ia?" question. Thisbmer answer 
"D" for decimal. How for the "HAHB?" prompt, give a * / " followed by 
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CF]. This » i&ip wa^ ta fiptcH^ 4 re-flsscmbly d-F tht fidmp +ilt 
Without hiving to pe-lDid thi snrcp HgmEnt, The 'OUTN?" prompt cin 
now bp answered 4jith 4 fil# name tobe Msignpij to IhB desbed loac| 
»9m#nt, Thifl tino we win creitt ant. Enter "TEST-L" followtd b^ 
tR], IfymihavethecissetW vfrsion, yoj diojld get i "OFF?" prfldipi 
now. LiHe with Ths Bdilor, The Atssfnbler is trying tcj protect you 
from your own neglect. 1+ yau h*fl left the recorder in PLAY mode h-om 
iht fiJe input pha»i The A^cmblcp ^ould hsve thought Ihit the 

recorder was ra-afly to record. ThiE prompt la your cue 1o put th* 

proper casMtie in the recordtr at the desired position on IFie tape- 

On» that is [Jgrw, you miy tsit liflj, Now the PRESS PLAY AND RECORD ON 

TAPE mp5H,ge wiil appear and you shoul-d tollovp- orcrtrB. 

H you have done ill of that, the recorder will start 
writin9, the Lsting viU Bsgin \o appear on tha screen »Fid this timt 
the addresses and gsnerated machine language will be in decimal 
initead d4 hut, Evenythir^ elM is the "sam*. You will notice the 
recorder or disK doing it= thirng ev^ry once in a while as load 
spgments are being written out. At "GWD?" tiin* the output tile will 

clasE. You now hdvf a file sawid io tipe qp disk which will be 
loadable by The Loader. 

There are two error messages which the Assembler can generat*. 
"ERP 3" Signifies a relerencB in the operand field Id a la&ei which 
has not tjeen defined snyvhere in the program. Fuilpwing the "ERR 3", 
the Otfeikding label will be printed. After the label will appear ^e 
actual michire language BrrDneousljTflfritrilefl, ERR 3 mes»g» may 
also appear before the listing of th& prograni begins during the file 
input fltage. ThHE rrsMi^es Hag EQU sti-teffiervts. whjch have labels 
which have rot been defined. See the Aaaeinbler specification chapter 
for more information or EQ.U statements. 



"ERR 4" signifies a relative branch instruction with an operand 
expression which computes to an address which is oul of range. 
flelalivB bran^hBi may be ta addresaes which ars a maxiriiirn of 117 bytes 
beyond or 128 behind the address of the instruction immediately 
fnloi.<ring the brandi instruction.. TJie aame information follows the 
"ERR 4- message as the BHR g, 

Ttie Loadvr - The capability to write, load and run a very large 

program is provided tor even the smaDest VlC-2a through the comhined 
U5e of The AsseitiMer and The Loader. Large programs cndy be broken 
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irrto segment* which can fit into the memory span? of The Assembler. 
BecauM The A»embler can create load ^pgments, the spice where Xhf 
maoKine language program i** designed to reside is not limited to that 
which is left Civer when The Assembler IS in memory- That is, a 
tailurp of somp assembler aystems is that the asspmtiier directly POKE 5 
the machine language into meiFiory. The iriemory where the assembler 
itself resides is thcrefoTE not available for the machine language 
program ^ince tne as^^mbler would be self destruct^ng as it was 
assembling. The Bolulion is tchave the assembler save the machine 
language program somecilace where another program can load it into 
memory. This requircB a loader program. If the iaader is a ^ert 
program A wiO allow the ma]timum possible space -for the machine 
language. 

11 IS also desireable for the loader to be able to input 
multiple laad segments to better handle the large program. TbisjThe 

Loader is and does. 

The Loader 15 written in BASIC and because of the way BASIC 
handles string variables, it might be ^lecessa^y to "proteiit'' your 

m&chine language Esrogram from the stnng variables of BASIC. If ycu 
are using a VIC with 8k or less. Before loading the sample program of 
the previous chapters it will be necessary to reset the "TOP-OF-BASIC" 

and "TOP-OF-STRTNGS" podnters in zero page* This 5fiDuld be done in 
the following way ; 

POKE 52 ,768 8 / 256 iPOKE 5 1 ,7ii 9 -PEE Kl5 2J •2S6; 
POKE 5 5 ,PE BKi^ 1 ):POKE5ri ,PE E K (521 



The Loader la loaded Just like The Editor and The Assembler. 
The program name IS "LOADER". Vhen you RUN the programp the first 
prompt a^Ked hy ThE Loader ic "NAHS?", asking for- the nane 04 the load 
segment created with The Assembler, Ft^^ the purpose of this tutoriali 
place the cassette with the tape created with The Assemb-ler in the 
recorder (or th« disHette in the dis^ drivel and key the nar^B "TEST- 

L". Theusuar'PRESSPLAY ON. TAPE" message will appear. Doit. 
The tape or disk should now f^o iis thing as the load module 
gets input and the appropriate memery locatLvnsget POKGd with the 
machine language program. As each load segment completes lo^t^ingp The 
Loader will asii ^or the KAK£ o^f the neut one. If there are no fnarv to 
lead* the response should be "/". For this demonstration we have only 
one segment. The second time -the "KAHE'" prompt appears* key '/", 
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Ai Ihis point thp machifie Isngu-age program creited with The 
Editor, aseemtJled wHh Ths ABssmbiPr and JoadeO wJlh The LodOer should 
bff in meiRory reaOy to be »*recijted. 

Tht LoaflPrwilMir^ipronp1yDUWitff"SAVE'\ a siting i^ you 
vrtxjlfl liMe to sa^ the machine Unguage program. Thi? can be 

particularly useful *or large imjltipls-Hgmant programs. Saving it as 
one lirge- prngrin will entbl* yoj to re-ioafl i1 lilce iny BASIC 
program with the usiw] LOAD procEdura. An interpatirv| sibt benefit of 
The Loider is that you may use it vithout loading any AsBemhler- 
generdtflfr ^mJ ssgntents. You may nee only the SAVE ititirt by 
respandinq with a V" to the first "NAME?" prompt. 

n you chcose the SAVE option, ^ou will also be prompted *or 
the low and high address oMhe SEqment yaii wish to save. These iruEt 
be entered in decimal. H is an unfortimate armmaly of the WC that 
for caBiPttfl savK, *e highest addrees which m^y be saved is 327i7. 
This was presumably a feature to protect car^nd^es from being saved 
However, it worHs fine for saving todiskottes, Itwoiildbea good 
encrcisB in wiflerfitanding 1ft* workings oHhe W^l^aMo attempt to 
find the limiting pnrtion of the operating system and to +ind a way 
arouTd it^ The De^ioder would be very useful in such a. pursuit. 

Vou may answer "Y" to "SAVE", and 7i8fi to TOW-ADR?- and 7A8# 
1D''HTGHADH°. Be sure to have a tape ready to record on, then answer 
"SAWTBST' io -NAME?-. Hiis will ciufie the crMtion d* a file on 
cassette for bisketle if you have the disk version) with the name 
"SAVETEST". ^w you load it back in if it is on diskette y&u must 
key "LOAD EA\^TEST,S,1" for at to load backJntD th« same spice you 
saved it fnom. If the file is dr cassette, just "LOADSAVeTESF will 
00. 

HtnU The Loader will a*-k you if you wish to "AUTO-SYS?". If 
you rtspond 'Y\ The pragrsm jiKt loadefl will Pxecute via a EVS to 
the iddresB specified an the last CQU in the program. H ynu wish to 
use this feature, the last EQU in your program must mecity the entry 
Domt of ycN^ program. Our program ftad sucf* in &au 50 we an try now 
to execute the prngran. Key a "¥" tc the "AUTO-SYS? " prompt- 
ly everything has gone well, you wilJ see the prodiice of your 
programming labors now displayed in the middle of tfie 6cr*en. If tor 
some reason this is not the case, it wcxjld be good to go back to The 
Sditor, load thB sourcs segme-nt with the men<j dfrtian "L" and verify 





that it IS correct. Kake any necessary changes and re-assemble and 
re-load the program. 11 should wflfk. 

The format of the lnad seginent file whith is created by The 
Assembler and gets input ty the loader is quite siinple. The records 
consist of thre^ perord t^pes: address records, machine language 

ncords and an end-of-file record. Every time The Assembler processes 

an EQU statement it generates an address record. Address record* 

cauM Th? LoAd^r to r^^et the addresc of v^t^ere to ne>:1 POKE th« 

machine language. The secraid type o-f record is a machine language 
record. There is one record *or every byte of machine language to be 

POIffid. As each machine langjage record i5 prDceasefli it ls POKEd into 

sequentially increasirig memory locations until ancth&r address record 
DT end of ^ile record is pncouritered. Tlie end-of— file record is a 

Single T. 



Where to put fCw nachin* langu«0* program 

There Are severaJ places where machine language programs truy 
be designed toreside. These include i> Inside a BASIC program 2) 
AfterBAElC 3} Below BASIC 4) In the cassette huffer (ia3C-(3FB or 
828-16 J9) 5) In e:<pan!ion RAM in block 5 C*Aftee-*BF«« or 489rift-49l52). 
6i Anyplace that The Loader itself does not reside. 

Irmidt a BASIC progriB 

To get a niacbine language prc^gram into a BASIC program sa that 
it may be saved with the SAStC program and reloaded right along with 
it, a couple of techniques may be used. The -First way is to load a 

BASIC proqram with several PS H statements which take up space and will 
be overlaid by the machine language, l^e token for REM must not be 
overlaid but every thing after it can be . 

Record the vdluc« of locations 13-46, i^ you v/ill need ^em 

later. Then load The Loader inta memory starting at some address 
above the BASIC program fusing the technique e>!p]ained in Apfxndix F). 

The Ladder and the other BASIC progrdiri w3l] both be in RAK now 
but in different Jocations. Now nji The Loader to load ttie machine 
language proflram which was designed to -fit in the space which t^e 
dummy REM statements created. This will nau^e the BfiKs to be overlaid. 
The best technique is to have the t^SH statemsnte at the very front of 
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the program. This way, ths macrt.ne language wili r«rl be ^m^4 
arou™i^evBry1imBtUt.ir,>nt5ar#.dfi»dtoo^0tl>t«frOm the BASIC 

It villbe n»i:«saJ7 to change earn* pumt.rs within it,^ ta.l 
0* your BASIC prograiii i* you o^flrliy nore than d™- REM. The Al5t REM 
DV^rliirf must be found in m.-nory and it. link iddr^^s tD the foLJowang 
«aUment must bB uKd 1o replace V\9 linK aQdresB o* the first RE H 
To rfo thu^Du should k™ the fc™-t D* BASIC ppcgrans m ..emtjry. 

LKltlCrs 43,44 contain the address at the ^irst BASIC 
=ta1*r.ert in your program. AUhit ddflres*, will be a iwo-byt* 
address of the ne^T BASIC fitattment. 11.1^ is the iir* addr™ 
rf *em»d Id. The end ot the ^ogr.pn i. ^gnitied ty - link .t<dr... c^ 
9,8. Immemaleiy after the hnK -ddrtss 43 the 5ta1emsnt numher, alsn 
in t^o-byte tormat. A*ter ih.t comes the ™mpres=ed BASIC statement 
which iS ended by a byts ot SQfl. =««mem 

^ ^ "^^'i^ *. °""''"' ^^^=^-'^"** P'''*fl''»" ^°r finding the ifldrtsi 
at me start 0+ afiy s-tatement in BA&IC: 

T-43iFORJ^tTaiee9e:i=F^Eka>+2SisPEEKa'fi) 
lKPEBifn42)4PEHK(I-^3U25i<>K,f>!THENMErr 



1 now ccsntainE the address of atatemtrYt 



HVK. 



Once the machine language has hnn iMded wiih ThB Loader it 
will be necessary to change the pointers at 13,44 anfl 45^i bacrt to 
^hat they w*rebBtoPe The Loader was leaded. Nov the Bask program 
thither'" "^ ^^"^''''^^ Pi'^wnger and they ruiy be all Mved 

Bi cautioned that luting the r-^jgrar. may cause furKiy 
charactere, maybe even cause the screen to go blank op da Dtfier 
strange thingg. 

There i=*«riou5flrawt,aWtotfi:t5VSlem. 14 your (^gram 
J *'***^'-*^*"i^Jt. BASIC will get confused and modifications 
and SAVEing the BASIC program will cause the linKige &Dinters to be 
reset and wUl tend to mes, jp your machinE langjgsge prograin. 

One turthep caution. There is another value which BASIC has 
troubLe wtth when withm 1 BASIC statement. The valui 14 3*4 i»CC». 

a MNTAX error wherh&tirg it. The program will still run hnwaver. 
And you ma/ list th« remainder of the pcooram by typing -LIST 3*-" tar 
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example if the syntax error ^tupped the listing prior to Etatement 
30. This might Of considered 1 sort al protBrtiOn -feature, as it is 
UKeljr to confuse the opposition 4at least for awhile). 



Another means of including the machine language progriim within 
eyt BASIC program 15 to run Tha Loiderj poking the machine language 
into memory which you Imow ta Q« a-fter the addrssa 0* the last line of 
B^IC code ir your hybrid pr<tgram. Now, load or enter the prograra. 
Hext change the start-a-^-vanabJes pointers at 45,4i to pount to some 
plact pittthe nidthineUnguage, This method does not raquir* the 
creation of HEHs and the machine lflnug:age never gets printafl but it 
*>#S flet saved and re-loaded with the BASIC prfjgrain. The problem is 
ttrat any mndificatiore to the BASIC will shift you- michins Unquage 
around. This could be a problem it you Inave absolute abdresting to 
locatlnns writhin Iha prooram- AIbo, B¥B» to entry points must be then 
changed too. 

AfttrBinc 

The upper limit of the memory spate which BASIC believes it 
hna available for BASIC programs is mdintiintd in ir address pointer 
at iocationsSSpSA. At 52,53 is snotJier pointer which BASIC uses to 
set the highest mem^jry address usable tor string storage. BASIC 
starts storing strings at Its hiehtti avftiiable rrrfmory location and 
worKs backdown. The free memory available in a BASIC program is the 
tpace between the high end 0* variable storage and the bottoni of 
fltring storage. It is possible to sa.ve msthinr language program 
segments in a space which will not be molested by BASIC programs if 
you modify th* tt^o pointer sets it 52 J3 and S5,5^ so that they point 
to anaddressbelow the machine language. Then BASIC will npt even 
((now of the existence of that memory space and will not try to save 
anything there. 



CaNetteBuHff 

There is a serious problem with puHing the machine language 
in the cassette buffer witu the cMMtte-based version of this Kit. 
■n^e Loader will need to use the buffer to read the load segmentSn It 
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camo-t Ihenfore POWE machirw tanguagp into it without iMing il as 
soon ds it rsids another reconli If you h*ve d di^Kette bdMd syfitsmt 
ihert is ru prcblvmp 

In «p«rwii3n RAM bhxM 3 1*A4H - ABFFF! 

Md prctiction 4poni BASIC ne*d bs irrtplsm&inled whan the prDgrjm 
is up hBfff. BASIC can't gsl tc blcxk 5. The onl^ prnblem is ttiit th* 
EisHttt uarsion o-f the SAVE won't worK with programs in block 5- 

Whff* Th» LiHdvr i«n'1 

Whtn the fnithine Unguage progrim :s not dMigned lo hive a 

BASIC compoMPnt tht prograrr ma/ always Q^ loaded with The Loader and 
run frorrr th^re. Or The Loader may be jncorporatedl in^o a. BASIC 
program. In both of these caEEc the ^M.d nafluies treitEfl by The 
Afiaemblpr should IoMqw on tha same tapa as The Loader (or the 

camfl:nation Loadei^/o-ther BASIC program!. 

l-f the loaded machine language progrsin is SAVEd with the 
Loader's hujlt in SAVE fegtjre as described above it may be aimply 
iMdBd dirsctly with a nonnil "LOAU"- 



in 



A liral note of caution. The loader takes some space 
mem^jry. If ths spat you wisTi io loa(J your inachine language program 
into overlaps the space cansiimpd by The Loader, loading the program 
will destroy The Loader. N your Loader acts very strange, ihis is 
the prnhable reason. The solution Is to Mlect carefully where you 
wish tci load The Loader ho it won't be overwritten by the program it 
ifi loading. 

CoAiHnuting beiwetn BASIC and Machine Languige 

As mentioned, one way of #>; ecuting the program \5 through the 
AUTO-SYS option of the Loadtr. To get to ths machine language segment 
from a BASIC program Involvts having sither a SY5 or a USR in^tnijction 
in the BASIC program. Executing (ruwung) a machine language prcjgram 
Which has no BASIC component and which has been SAVEd with the SAVE 
option of the LOADEParrtautrtequentlyLOADed with the normal LDAD 
tqmmand invoves typing a SVS or USR instruction m direct mode. 
The te'ioatol ths SYS statement 15 "SVS addr". i^ere addr i^ 




the address of the first statement in the program to be 0>;:ecuted. 
This will cause a Jump to thf 5per.ifiect addreat. Data rray bt passed 
to thi machine Language progrim by POKKing it into some memory 
locations where the machine language program has been programmed to 
find it. It may also &e passed directly to the A-regr Jf-regi Y-reg 
and P-TBg by POKEing it directly into locations 7Bfl-7S3 respectively- 
■ftie BASIC EVScOEtirfiartd iutomiiitally la^ds th*5ef6iXWflHt*fs with 
trie values found in these locations before passing control to your 
machine language program. H also returns to yotr BASIC prograin wtth 
73§-7S3 containing the value-G c+ the above rsgistc^ as your machine 
language program left them. 

The UEP instruttiQii format is ■':f-!ISR(A)". This instruction 

19. UHd in pUce of the SYSwhen you wish to pa53 a real variable 
{floating poirrt njmber whidi contains a fractional component} to the 
machine language prograin. I^he value of BABIC variable "A" is loaded 
inip ttie flOdtirig point accumulator tt i bee that^ter 13 iw a full 
explanation) before passing control to the machine language program. 
Upon returning to the BASIC program, the value which ihe maqhine 
language program leaves tninthe FACil will be assigned to the BASIC 
variable "IC. The address of the entry point of the machine language 
program must be £tcrBd in luaticns I And 2 pfior to executing the USR 
instruction. For eKamp^, if the entry point of the program is 7fi*S, 
you must have the fnnowing BASIC statement preceeding the USR 
infitntctinn. POKE2,7A*e/Z5d: POKE 1,76&9 -PEE Kl2)*256. 

With both the SVS and USR instructions, the way to return to 
the BASIC statement immediately following the SYS or USR is by the FTS 
irstrjctior in the machine language progrdn. 
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7T» Homtor - The rtooitar provides the cipibiliiy of runriing a machine 
Janguage program ant instrucitiofi nX i -time. Aasich instruclior i^ 
Pi^etutedr theintBrnilregislersof the VIC's 6592 microppacflssor are 
dispJayed, including the individual biis o* the status register. ThB 
instrurtiDniohe PAecuted is alaa rfiaplayed, both in machine ianguaige 
find inassembt^'lnguage. The cawbHily " proviaeO to byoas^ It^e 
B>iecution 0* any ir^strurfion and to dispUy md modi-f/ arvy memory 
Iwa^on whiifl iri the process a-f running the program. The menu c* 
choices is displaced at every step a* the PKecutign. 

For the purpoM oi dfrnonBlpating the feitures o* The Hordior, 
you ^Duld have losJed into memory the program created, as^mbkedi 
loaded and run in the previous chapters. If The Loader just loaded 
trie niichine languige progpam-TEST-L" avBrythuig shoulflfie ready to 
go. Otherwise you will need to go back and load it aga-in i^ith the 
instructions in the previous chapter. 

Like with The Loacicri if youa.rr jsing a VIC *tth Bkor Iss^ 

it will be necessary to modify the TOP-OF-STRINGS and T0P-0F-BA5IC 
ODinlers at 51,52 ard !5»5i belore loading The Honitor. See the 
ppviDus chapter for in-Forniation. U the pmnUPS have ngt been 
restcsred sinte the previous modi-fication o^ these pointers it wiL not 
be recKsary itt do it again. By ihe Earn* token, sufcseciuen-t prograns 
which are loaded without resetting these pointsrs may find themselvss 
"OUT-OF-MEHOPV" because of the change. 

Loading Tt\i Monitop is by the ^me process is with all programs 
in the Kit. The name of the program on the distnbutior media is 
"HOHITOR". It nay sometimes be necessary to lead The Monitor into some 
part of memory other than where BASIC program* oormslly load. 1* Xhw 
program you wish la monitor is jn the ncrmai BASIC space you may want 
to load it into some other space as per instructions in AppemdiH F. 

For the purpose of this tutprial, Ttie HDOitor n^ay be loaded in 
the usual space vflthout madi-Eyirtg tEip pijinters. Once i"t is Imtied, 
Key'RUH". The menu should now appear. 

"S" is the menu option to (S)flt the address ai the ne>?t 
instruction to be executed, it wril] be fallowed by the "ADR" prompt, 
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a.sking ^ ihf st-irting address. Valid r^lys are decimal numbers in 
the range 0^ 0-£S535 and hexadecimal numbers IT the range of tSAftft- 
tfFFF. 

"W causes The M-nmt-cir to en^er Ihi tMleiinory display /modi^ mode. 
This is also follciwed by the "ASP" prompt, requesting the starting 
address of veiwring/mgdi-fyjng. 

"B" will CAJ9« the instruction ^out to be eii:BcutEd to be 
(B)yfHBSBd. Rather than execute the displayed instruction, the 
irstructicn fnllowing the displayed arw will be bisplayed. 

Hitting TRJ with no menu MlectionwiL cauu tht current 
irstruction to be e>:Ecuied and the ne>:t instruction in the program 
flow to be displayed. 

Key a "S" to cause single stepping and answer the "A^^' prompt 
with 7fi(l8i the address ol the entry point ot the program. The first 
instruction of our program should nov appear on the screen. 

Afl eai^ instnjctlDn is about to be CKeruted, it ie displayed 
in both machine language and in a-ssenibly language- The status 
register is broken into its individual bits <H = negative, V •■ 
overflowi B = br*akmod*( D* Decimal mode, 2 - Zero,] = in1prrijpt5 
inhibited, C = carry). The other registers displayed are the A-reg, 
the :(-reg, theY-reg. and the Stack Pointer fBPl, Upon execution of 
each instruction, the rtgisterfi are loaded from these save artas in 
tnfititjry- 

X-251 Y'?S2 A-2S3 P-254 

II you wish to modify or pre-initializE any of the regiaters 
at any time you may dc so by entering the Hemory-Modify mode and 
modifying the above locations. 



A "software" stack is substituted for the hardware sTacK in 
pagp t. its masimum depth ispre-set at ?fl bytes. Uhiie this will 
bf Bufficitnt for the vast majiM^ty o# your testir^gi you may increise 
It If necessary by settinri the new maximum depth in the SD variable in 
statemsM I. H, while single-stepping IhrcHjgh soiFie program, you 
should BfiECUte A RTS orPLAorPLP without first having pushed 
somthmg onto the stacK with a JSR or PHA or PHP, a stack underflow 
will occur. A TXEmetnttion setting the SP to same oul-a+Tinge 
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vdliJ« will Also cause ^ticlfi-BiderflDw- OverfloN^s ar* causes! by 
repetitive PHA's PKP'sor JSR's without CDrrrsponOing PLA's PLF'S or 
PT&'aurtil tti« mdhirTLLim stack depth ^ls been exceeded. In th? ^vent 

Df undpr^lo^s and □v^r^lovi/Sf a"BTKERE)" (ne5^ar|« wilt be di^Uyed. 
EK«ulion may cnrtirij* H de aired but results 4r-e liKeiy to be 
urteKpEcied i^ yoie- rrioritored prograrri is expecting to (ind sorriE 
signi+icdrrt inJormation in the stack (ItWc a return address). 

Certair m-achine langudge progranis are writlen T-d modiJj' the 
Stack directly by storinci data in the high end of page I . Executing 

these ii^trtvtlHVi^ with The HonitDT will mt cauae the desired etacK 

modification eHect. Ir fact, it is ipnie liKety thai The Honilor 
wilJ actually crash ypor the evGcution of such instructions. Since 
The Homlnr is written partially in BASIC,^ any inatnjctio*is which 
modi-fy the BASIC vpctors or other mformaticn vital to- ths running ai 
BASIC programs may cause unwanted re^ult^^ 

As The Homier single steps through a. machine language 
pragra^i it di&cks each op-ccxle encountered for validiiy. If an 
invalid op-code is encnurterd, the message "OP-CODE = xkx" {where it«>: 
it thfl encaunlEretf op-cotfe) w^jU appear where the mnemonic would 
otherwi-se appear. The Monitor will rot try to execute invalid op- 
codes. Wop willit try toeKecute SRKorRTIin5*rurfiorw. Allot 
these will be automaiic^lty bypassed. 

If ysj have treated and leaded the sample pnogram and tiave 
loaded and mn The Honitor- and have selected menu option S and have 
answered 7ias to the address promptp you will now see on the screen 
the a^^pinbly language ^tat^m^nt "LDY #0" fcillowfrd by i line with tha 
address 7698 and the machine language squtvalenl at the above assembly 
language statement: i6i 8. 

FollDwing the m&chine ImgiMQ? will b« the display ot the 
registers prior to the e:<BCLJtiDn of the displayed instructicxi, Thay 
will have nc particular significance at tliis point because they were 
never initialiied. Nolti howeverp the value of the V-reg because 
after ejeacuting the instruction it shouleT tftange. The Zero flag, if 
it is a one now should also change as a result of ths SKecutiDn of ^e 
instruqtinn. To execute the ins-lructioniMt return. Do that now. 

If all is well, th^ ne^t irHtructiDno4 the sample prcjgram 

Will h» dvBplayod and the first instruction will have been ertecutid. 
You may verify that by checking the Y-reg. It should be ol value 8 
r«w. The Mro bit *hoiild be ae because th* result pf loading the Y- 




ng is not ztro. Note the disasHmbled statement is rvA identical io 
the assembly language statement we wrote. It isequivalint but not 
identical. We wrote the statement LDAt»9*22+4. The displayed 
statAHTTt stVDuld bE^ LDA 11212. This discrtpanfy Mrurs becLuta The 
Konitar can't teD what went into The Aasemhlftr, only what came out 
ind it does th« best H can in reconstructing i valid assembly 
languagE atatemint fix)iii the michine larguage it hai to worH with. It 
generates all operand field values at a simple decimal value. When 
this inslnxtion is eHecuted we should see the A-reg's value reflect 
the LDA opcntion. Note also that the number 242 is greater than 177 
andh ai suchr the high-order bit is on. Cotisiciuentlyi the Negative 
flag should be turned on by the execution of this instruction. Hit 
CR} and »e. 

The nejtt imtniction wtiich is now up for execution will store 
-the A-reg in locatian B-, Hone of the status flags are affected by 
this instructioTi so we shoiild see no change whrn WT execute iti Do 
it. 

This would be a good tlmi to looM it the HBrnory DlBpUy/Kodi-Fy 
mode, Rathirthan hit [R] at this time, Ke/"M [RD". You are now in 
the K-iihode. 

Upon entering Memory mode- the address where you left off in 
single-stepping will be saved and the "ADR" prompt will be displayed. 
You may inter the first address you wish to examint OP modify. The 
address may be in the range *-65533 or tflflefl-»FFFF. The value of the 
datt stored at the requested address will be displayed and the proenpt 
"WALT' will appear, Yvj may do onr of Wre* things. You may eXit the 
Hemcry mode by keying "X". You iiiAy modify the displayed location by 
Keying a value in the range ft-2SS or fc88-tFF. You may continue 
viewing the nenl sequential memory locations by hittng tRJ- 

TolE»katl«atianfttK«ya'«CPP. Ihe adf^^s te^ will be 
displayed fodlowed by the cortents of the specified location. In this 
case it should be 202 because that is the value wi just storvd there. 

Following the information line wiD be the (luestion "VAL?*- 

Ydu may now change thi cortents of location I if you uash by 
keying some ns-w value- The next location will nov^ be displayed, 
memory location i. Kote its contents and modify them i^ you wish. 
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To Ajfit 5can Wroijgh inBm-ory^ siirply corrtinue 1q hit ER] tich 
imt a value 15 diepl4ypd. Whan youwish toreiurn fo thunam iriflnu, 
Wy "f' forwit. OncE this hjab«n doner the SHH menu ahould 
TB appear. 

il yotj modified location -8 ymj ahould now r»-enter H-mcjda by 
enlerir>g the '*H" option, and adflress t again. When tiie value you 
5tJcK inflisdispJiyedj change t1 badl Id 282. hil [fiH, and when 
Iccatioo I is displayed, hit T to get out a.gain. 

how to return to the program we ^ve^e single-fileppjng through, 
fiiraply hit IR]. We coulfl have started single-sttpping at any location 
we wanted to by entering option ''5' and the new address ^tfhere we 
wanted to go to. 

The rmuX instruction in thj program is now displayib. It is a. 

LDA inetructian. Note the registers still hive the 5a.me contents as 
bBfoffi the H-flioiie eKcursicn, The A-reij will now tie loaded from 
location 648. Locaticn fi49 contains the optraTing systam's 
information about whtch page of mpmary the TV screen's data is Kept 
in. When puttang data intDtPie Mreen's meinory apace, it will 
automatically appear on the screen of your TVi Hore atiPLrt this in 
later chapters. 

This program is setting up a vertop in Iwitions * and i oi 
zero pagp to idCreas the 4th column o* the ¥th line ot the screen- A 
loop in the program will seqjenlially move characters from a data area 
in ^e progrim <MSO) to the screen memory where they will uoear on 
the TV. 

Hit Cfl] and sea the neKt instryctinn which is a Store of the 
A-rrg to iotation 1. Hit [R] again. Ths ne:<t instruction ii the 
beginrdng o-F a loop. It loads the A-r»g with the character at addnsa 
7595 plus the contents of the Y-reg. The V-i^g should still have the 
value o# 8 so the address whept dat* is bring pJcKeLJ tp from is 7599 t 
8 or 7Afl7, Go antn H-mode anfl ue what is there. It sNould be the 
ASai vdlLJB oi ihe letT*^ S, or S3. This is the last character in H5G 
m the original assemhl/ lar^uage program. 

Go back to the prijgram now b/ exiting and responding to the 

menuwithi [R]. The instruction will be e^Bcuted. Th* A-reg should 
have the value 83 and the A ND instruction ia up now. Its function is 
to convert the character in the A-reg from ASCII to VIC screen forinat. 
Tht Kppen format for the letters A-I have the i-bitcrff w^ile the 
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ASCII Eharaciera have it on. The AND o^ the A-reg viVi the hex value 
t£F will acc&mplieh that. Stc Appendix D o^ The Pr«|rammir£ Hafar^fcfr 
Guide for more information. 

Evecute the Instruction and notice what happeni to the A-reg. 
It now has the value oi 19. The &-bit has a bit vaiui of &4 and 
tLrnlng it of-f should reduce the value ot ttie A-ng by 6A. Uhicti it 
did. The next instruction to be e^iecuted will store this value at the 
locatiDn computed from the sum of the contents of the Y-reg and the 
address vector in locations A and 1. H you taUe the value stored at 
location i (which is the page N of screen memory] and multiply It by 
?5fi and ad0 Iht value storea in Ix^tion ft iZ*Z or 9*22+4^ ^ou will 
get thi tiase address to vrfiidi th« Y-reg is added. All vectors htforK 
tb>e aane way: add the cDntents of the first byte of the vector to 2S& 
times the second byte to get the addre$$ bejng rpfersniTedi 

After executing this instruction with The Honitor, it may 
actually be difficult to find the vaiufr whDPA the prcgram juEt put it. 
This is twcauae the screen memory i5 modified by every program which 
writes anything on the screen. The Hani tor writes quite a bit to the 
screen^ so the screen rriBma^ ii.jlt#red about a a +ait at our little 
program can put aomthingi there. This is one of the LinfortL^ate fact« 
ot IHe in debugging programs. If we know in advance to expect this 
Kind of problem wr may not end up qmte m confused when it happens. 

Enecute the ne^t instructipn, the DEV. The Y-reg should now 
have the value of 7. Uhat is the contents of the Z-flag? It should 
t» zero bccatiw the DEY Bid not cauM a result of itro. Ei»ecute the 
n»tct inatruction- The BNK tests the Z-#lag- It brafiches i^ the Z- 
flag is notaonfl. Iti^ruJt^ so the branch should take place. 
Before evecutmn the 6NE| check the address of the marine language 
instruction. Now e>Lecute the BKE. The new address of the machine 
language instruction ib Isee, In facth the new iastructian f&ady to 
be e>[ecuted is t^e LDA back up at the top of the loop. The brantfiwaa 
taken. 

It wjuld be good new to step through the loop quicUyt 
watching the Y-rog get smaller and smaller each time through. Whin it 
gets to one, watch what happens at the DEY. The lero-flag should go 
fr-om * to 1 when the Y-r»g goes from 1 to ft. Tha BHE Hien should not 
take the branch. The afldresa of the instruction up after the BNE 
should be twogreater than the address of the BNE itself. At this 
time, all eight bytes of KSQ viu hive 6e*n copied into OTTtn mtmory 
(only to be obliterated by The Monitor), 
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When ttiia program Mias run Qy the loader, the mdchinp Unguage 
program had con-trol lor the »ntirt flm? Ihe diaran-tvrs wer« bsing 
cDpiefl to V\a sere br» Tht LDaflerdid no further screen attivity so you 

vnrv -able 1o see ihiiin ip^iear on your scrEen then and not now. 

The lasi irsiruc^ion in iht pragram is t-he HT5. l^is is the 
^a^ a program enttred by a BASIC SYSre-ti^ns to BASJCi if B^LBCUt'ffd 
nowr it will try to return Kirough a BtacW which does not have any 
retLjTTi ifldreES to retLrn thrrvugh, Th^ Moniiiir warns yoip fha-t this h«s 
happened. Try e]f*CLiTing it and see. 



The Monitor is l v^ry power-Eul ^ool -For *othi debugging and lor 
lEarneng 4^aw the instrucfion set uvorki. Ydli can u^? Lt ta fiinglft-«tep 
any machine language (jrogram inciudirig the BASIC o|jei'ating system. 
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The DflCDClvr Th* Eippasite of Thie Assenbblerr The Decoder tirns machine 
language bac^ Into AEficmbly language. The format of th« iSaembly 
IdnguagB program is idfntiul tothatwtikh 1^« As»nibler ind The 
SdltDr accept ac input. The Decoder prodLices tht program Lifting to 
the acreBfi, optlDnally to th* printer andp also optionally, to either 
the casHttr dt thi ditKitti Mprndlng on the vtruon of thi 
Deve-lopment Kit you hav«. 

1^« Decoder produces ill address and operand fields in 
diamal. It dof3 nutprodun libel-9. The prognra crcAted by The 
Decoder will reeemble the original asftambly language prograin which 
r:reiied the machine language t»ut it wili not be identical. This is 
due in part to the lack of label generation. It is alu due to the 
great flexibility available to the asseFnbly language prognminer in 
■ptclfying addrB» «>iprBeuDrw. T^e Derodfir un'^ ttuw whit the 
anginal expreaaion was. It only sees ttie end result, whic^ is an 
addrB» or immediate data value in binary. It converts all such 
iiYformatioT to a Simple deamai value. 

The Deioder is loaMd and pui in the same manner as the other 
toolm. The name of the program -on the magnetic media is DSCODGR- The 
DscHltri liKti The Honitor and The- Loader may be Loaded into any 
available T^AH. The first proinpt you receive when you run Tho 

Decoder is ■'^HAP". Thit prompt is atWn^f for the maximum segment 
sue ypu might wish to ^rtit? tv eventu*! input to The Editor or The 
Assembler, If you have no intention of using T^e Decoder for this 
purpcaei you may hi4 [R]. If youdc mate a wgntrrt cmcassete or 
disKctte to be assembled and/or ntoditied by Th» SditOr and The 
Assemblerp reEpond with the maximumi number of assembly language 
statiminta you wi^ to automatically create with TF» Decoder, H you 
Hlect the option to create an output file, the program will 
autDinaticall> stop decoding upon reachirtg the entered rna>iiiTrum value. 

The ni3<t prorrrpti ■'PRINTDtJT?% allov/s you the option o4 
creating printed output. I* you reply with a "Y" yuu will 
automatLcUly receive a printed Liting tsf the decoded program on your 
ViC-1313 printer iDT equivalent). Any other reiponH including just 
CRD wilL suppress printing. 

NeKti you are asked if you want to create an output file. It 
yoj answer "Y° it ^H ciuK a copy of the QBCOded A&»Fnbly text to be 
automaticaUy SAVEd to diskette or wisette in the special format 
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rvqutr^ri by Th? AsumblBr and The Editor. Any oiher re&pDrK« wiJl 
auppre-sa SAVEing. If you do -so diDOBBi you will b» promoted for ths 
"NAME?" D* ihe segment to be savpdT Yqm may respord with thp irsua] 
legal file names or f in tbe case o+cassttieF na n^np. In the casfl of 

the disi<eU«t if you Key a name lireidy m existence on the di^lir, 
The Decoder will replace th? old verstor with tha rww. 

Ydu iFiuEt tell The Decoder u^bere io begin decoding by answering 
the "^ART ADDR?" prciiiipt with sither a decimal number in the range at 
&-d5?37 or i hex mmbenn tha range t9H9 -tFFFF. 
[f VDU Pfspcjnd by hitting [R] without any flntBrcd viluo, Thfl Decoder 
will begin becoding at the address where it le-ft oH. 1-i this is ths 
first decoding ^nce /ou loaded the program ■ hitting just CRJ will 
tsuw it to start at iddrss^s ft. 

You must tell The Dicoder where to cease d^coHtng by your 
r¥^cin5« tc'BND ADDR?". Your reEponsB may either be anaddresa or a 
BpanfLC cp-:ode. H y-ou specify dn addrses, i1 nnaX be in the range 
Dt 0-A5535 or >4S04-1FFFF. [f you s[Kcify an ocf-codv you mint [ireceed 
the o|j-cqclP with an"*". The opi-CGde may be sped^ied in either 
^am] V hiji i'V preceeding U^e op-code and after the "tt"). 
Specifying an op-code will cause Tht DKoder to check each op-code as 
it dicodea the machine languacre and to stop decodirtg aft»r the first 
Dcnrr<^nt9 gf tb? ^ecdf ied ap-cods. Hitting simply EP3 will causp 
the most recently entered response (either op-code or addrf^&l to this 
pranipt to rariiain thp active fitopping sigrul. In other ^affis, if yu 
decode several 5iJbroiitin«s you only have- to igive tiie #f£fl respcn^p 
oncH the first time» hitting CR3 the following times. 

Thp firct ctater^ent output will always be an EGU ^tate^tnt 
which wiU hav0 is Its operand the dsdmal value of the Start Address. 
Each statement, as it is generated, will display the decimal value of 
thB address at which the dHEOded initnxtion m«id.eB in msntDryi The 
address will tie followed by the mnemonic tttich as JSH or BNEl. 
followed by the operand field- Tf an ^ivaJid op-code is entoimtered 
by The Dec Oder whare it it CKpicting to tind ant valid £592 Dp-code, 
a BYT instruction wdl be gerwrated having the decimal value of the 

encountered byte as its operand. 

The operand -field will indicate the addresfiinci mode with Hi* 

following conventionii ■•'' as -tfw first character of the field 

iTidicateS Immediate tuM*. "i-" will pre-CE Ed tha operand field of 

zero paife addressing and a*(X and ZPtY- Addresses enclosed in I. -J 

are designated indipnct addressing modeft- The auffineaof fK and ,Y 
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imply inde*:ed by peg-): and reg-Y respectively. All address values are 
enpres^ea in dccimilp 

After the Decoder reaches the designated end o4 the segmenti 
whether by hiHing th« H AX value in the case of a SAVE, or by reaching 
the high address or by encountering the specified stopping op-codei 
The Decoder will return to the prompt for "PPTNTOUT?". You may now 
decddt inothep uctior cf memoryF selecting anew the options 
(PniHTOLIT, SAVE, START ADR, END ADR) 

Decoding cartridges is not a prDblein unless the car-^dge is 
in autostart cartridf^E- Then it is genepally necESEiry tohavp a 
hardware assist' Hany e!<pansion chassis come with a set of switches 
which enable and disable the various slots on the cartridge. With 
thie featurei th* iuto-start cartridge may bp effectively deccided. It 

is necessary to have the cartridge ma switchable slot ai the 
ei^pansicm ch-a^sis with the s^ot disabled when the power-on or reset 
process occurs. Oncft that has happened i the slot must bP Pnabtsd by 
throwing the switch. Now the cartridge is in the itddressabie space 
and you still have tcntrol of the machirte. Load The Decoder and 
specify address (A0e« as the starting address and decode away. 

To decode cassette or diskette based programs which start upon 
Joidirtg, it is. n«c»=airy to have a reset button- Host good e>[pansion 
chassis also have one a* these. Load the program, hit the resetr load 
TEie Decoder into some space not used by the aulD-start progranir and 

decode. The rEH*t function will destroy i fnw bytes of data at the 
ST ART-Of -BASIC. If you have an expansion chassis and some expansion 
RAM, It is possible to change the STAR T-OF -BASIC by switching the 
Bxpansior RAH either on or oii. With e>;pinBlDni th* start adbreat for 

BASIC is 469?. With no eKpansion, the address is 6^7. 



The Decoder is a powerful learning tool. With it you may see 
htiw other well written programs do what they do. The coding 
techniques of others can become jixorporated in your tiwn bag of 
tricks. They will provide you a valuable base for building your 
sKillft inventory. It can he particularly helpful to eKamir^ the 
operating system to more fully understand how the VIC was designed and 
how its internal features are utiltied by the systems prograrrimers who 
wrote BASIC. 
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Ths label fi*irif it u»d. is ths firsi field of tha as»mtoiv 
atatejnent. It :t not a required field. If uaed, it miist Start wilh a 
lEt^er tA-Z> and may tte of any length. The sir^gle chiradtr "A" 

3hculd not b< ueedp aa it will tie confused LJiih We "A" oi -the 
Accumulator addressing mode when appearing in an operand lieifl, Q-th^r 
characters which sho^^ld ha avoided are the seven algebraic opepators 
and the qloIp C'K Labsls n* morB than *oup cftaracKPS will cauw the 
assembly iirting tc Bt somewhat less rwat app&iring but wwk just 
fine. The longer your labels are, however, the less stitenefits ihat 
can fit into i segmenti 

HniiK3ni« 

Standard mneieonicft 

The mnsmonic is the English-iiHe code wtiich gets translated by 
The Assember into the machine iangua.ge op-torfe. A discussion af the 
mneinonicH is fojid in chapter 5. See apptndiir A fcr d complete list of 
all valid mrwmonics and their Isgal addressing modps. 

TlH BQU puudo-op 

The Assembler comesequipped with twn special mnerfiDnicB, SOU 
*nd BVTi These da not generate pro«55tir-e* ecu table instructiDna as 

do the standard mnentonics. The BYT paaudo-op is CGver«d in the next 
paragraph. The EQU mnemnnic is an instruction ta The Assembler rather 
than an instruction to the machine. It has tWDtunctioro. Thetipst 
is to set the location counter. This is a function sometimes left to 
i sepafite pscudo-pp such as ORG in other assemblers. The second 
function is to ecjuite i label with an address. The format of the EQU 
inHtructioTp is: 



genera] rules for address expressions fpr tt^e EQU instruction. The 
eiipr&ssian nay net referBrve labels whidi da not preude thB SQ.U 
instrtjction in the segnent. This is true only for the EQU instruction 
and is the only limitation on it. Any program references to the label 
Qt\ Vte EQU instruction wiD refer to thr address eK^precud in the 
ppera.nd field . 

T^e last EQU in a set of source segments generates Joad 

SEgmtnt cade which The Loader interpret^as the entry addreii of tfie 
program. Tt^e Loader will a^ if you wish to AUTO-SYS' at the end of 
loading load segi^ents. U you answer "Y", it will SYS to the address 
ej{pr?5sed in XUn EQU. 



The BYT p»tKto-op 

The BYT inslJHJttior^, uniike the EQU instruction, does cause 
machine language code to be generated b/ TTie Assembler. It is not 

generally used to generate ei^ecutflble code liKc the standard 
mnencnicsi Its function is to provide a means o* causing data to de 

stored in memory. The data generated by the BVT instruction may be 

specified in several ways. Depending on the first character of the 
errand field, the BYT instruction may specify h*>:adei:imal strings cm- 
ASCII strings op address constants or single byte values of he>i. 
decimal or A&CH. 

Kexarieamal strings 

If t#ie f jrst character of the operand field 15 "*' then a hen 
string will be generated. All characters following the "t" should be 
het digits, 6-? A-F. There may be any number of sjch digits. The 
AsseiTihler will create one pyte of data for each pair of digits. If 
there are an odd number of digits, The Assembler will append i "#" on 
the left of the string.. 



Literal text etrings 



LABEL EQU flrfdr-ex press ion 

The UbeHitlbisoptionsl. There is ono cjiceptior to the 



I* the first character of the operand field is a ' ' ", all 

following characters will be translated to the CommQdore ASCII value 
of the characters.. Each tent tharacterin the operand will generate 
one byte of data. All the characters which may be entered from the 
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keyboard with the fti^ttptiOT cif the quote <, " ) are legal. ThE BYT 
lite-ral instruction is the on^y instruction v^ich riannDt have a 

cnmiTiEnt -field. Conments v^ouLd be interpreted as part o+ -Mie literal 
te>:i. 

Data com-tvita 

A "fl" m the first pcs-ition ai the operand H9I6 causes the 
expre^^iGn whLi=h ^Dllows to be evaluated by ^e ruLe-s n-f address 

e^pr9E£iDn evalu9,1l[>n. The ^in^Je byit wf\iC\ isgenpr^ted ic thp Idw- 
DTder B^te of ttie rEsultant two-byte evaluation. 

Addrf aa CDnsUrts 

H the first (haract&T o-f the operand doBsnoi meet eny 0* 
Ifte above criteria then the operand 15 evaluaten as an address 
expresEJDn as defined later. The two bytes of data which are 
generated are in the 65ft? address fcrmatt wilh the iDW-nrder byte 
preceding Ihe higki-oroer byte. H shoulri be noted that i BY7 
instruction such as: 



BVT »3CC 

will not generate ^n a^Jdress constant in the iowHiigh format- 
It is a he^string anf^ will generate 62 CC. To get ar address constant 

it would be required to write sn inMruction 5ucf\ as; 

BYT e*i3GC 

which ^MDuld generate CCQSias e>:pected- 

The following will also generate the same address e>rpre5-£Jci[iB: 

MSGEQlJtSCC 
EVTMSG 



Ttw opvrind field 

The operand field follows itn mediately after the mnemonic ^ield 
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and specifies to The Assembler the address of the data to b« accessed 
arO the modu &y which It will be iddreasBfl. "niere tn irtually 13 
distinct addressing irrodes by which the location of data is specified. 
The format of the operand field determines which mode will be uaed and 

theraforp ejiclly which op-code will Qe genffMled and how many bytes 
0* address data will be generated. Kct all instmctiDns may use the 
same set oi addressing modes. Appendix A specifies the valid 
addre-ssing modes tor each irtstnjttior or mnemcnacj 

Address ex[r«suon« 

One erf the great strengths of this assembler is the ability to 
create address eiiprK^ons d* great conplejiity Cor simplicity^ with 
ease and fle«bility. The term 'addriss eKprtssior' 15 meant to 
include the "immedia'te" charactpr and BYT data constants as we-ll as 
actual memory iDCitiOK. 

TtfBW 

There are five different kinds o* terms which may be 
algebraicly combined in an address exprpssion. Each has its own 
dtstinguiBhiog tormal to identify it. 

DtdnaJ forrut 

Any term in an address expression which begins with 9-? or a 
".' will be intorppfltedaBadeajnalterm. EtfniTid terois may be 
integers or rmay contain a decimal point and a fractional corsponentp 
There is no practical upper or lower limit to their magnitude. 



HeiadtDBa] format 



Hejtadecimal terms are those which have a ■*" as Ihe first 
chwicter. All following charactersf Ljp till the ne<t operator or the 
enfl of the e>[prefisionr must be (-^1 A-f , 

Literal tornat 

Any term in an adOressenpression which begins with the 
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chiPictflr" '" will bt in+Brprsted as i literdl. Thai i^, th* valut 
assigned to that term will b« thff ASCII vdlue cjf the first ctiirairter 
Id the right of the " '" , Any chiratterB following the +ir9t 
charac-ter -fQlLowing the quotfi will be ignorBd. 

Syabolic label 

Any term i^hich dw& not start with a "t" or a "" or d "^ or 
a"." or a number (ft-*) will be irtBrpretefl a«a ay iribolic label. The 
Aft^rmtlcp will warch thp tntire program Joctking -fori matd> or Ih* 
l^ellield. If none IS fDJid, ERR 3 will be generated. If a match 
ifi fojrf, the term wiU be assigned the value of the address 
iBHQCiated with tti* iatiei, Libflla may be of iny I»ngth, 

Loca-bcn oMMTtcr 

The iDcatiop cDunterisThe Aseembler's etiuivalent of the 
progpan caLnter. The Iwihon counter hat the value of the nrrent 
address aasigned to (he -First fi/te o* an instructior- Jt is Ih* 
addrP55 at which the instruction wiU reside once The Loader POKES the 
load Mgncnt into mBinrwY. This issBmbltfPJMfi the "3" symbol to 
signify the location cotFrter. Most other aaEemblera use tha "fl" 
symbo] for this function, However, the "*'■ is interpreted by Tf>B 
Assembler as a multiphcation apprator. The '^S" symbol te-enm a 
logical choiceF being the "at" Eign and signifying where we ape 'at' 
in memory. Any term which has '**' as its fipet character will ha^e -the 
viliK of tie latition counter. Any following characters within the 
ternip should ^ey e)tiEtp willbe ignored. 

Algtbruc opHitflr* 

The vaF'ious term-% of the address ej<pres5iDn may be combinfld 
algebraicly by the following Espirators: *-■/"!* . As the 
evaluitior prMeeds irca^ teft longht, each tern is added to, 

subtracted from, ikultiplied by, etc. thP rvcult of tha tvaluationfff 
that portion erf the eopression to the l«ft of the operator, giving a 
new CLirrent evaluition. The fractional portion of tJie result o* any 
Dp*ration will be carrisd into the wnt operation. The final 
ivaluaticn of the enpression will tPLrtcate any fractional componenti 
and will conve/^ relative numbers into sixteen bit two^ compleeient 
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values. 

Ai»dltinn" + " 

The acHliliDnDptratorcauuB the term immedialily following 
the 't" to be added to the result of the evaluation o« -the portion of 
the eKpression to the left of the -*". 

SiAtrutlon' -" 

The 5ublrattiM-iop«patarcauMstheteM^tolftepightDf the 
minua sign to be subtracted from the e>rpresswiri to the left of the 
minus. 

HultlpUcatlDn " f " 

The nullipllcatiDn operator causes Ihe eMpression to the left 
irf the ■ * 'Md be multiplied by the tepm to the right of the ' * " . 

DiviUcn-/' 

The divi^inn operator cauHS the expresHon to the left of 
the ' / '^ to be divided by the term to the rigtil of the " / ". 

BNpOfltntt*tiDn' *■ 

TKe power operator ciumi -the Bvprteftion to the le4t erf the '' 
-" ° to he paised to the power of the tepm to the right of the ' * ". 
Fractioral powers may be employed with decimal terms^ It is therefore 
Dssitsle to do such thinas at tato tquar* roota with ei^ppBailoris such 

as: 

X" .5 



Logical AND ' 1 - 

The logical ANr operator »uses the result of thv evaluation 
of the ewpreasion to the left of the 't,' to tie logically ANDvd with 
the term to the right of the ^k" . The logical AKS operation compares 
the two terms of the Dperation bit by tiitt giving a result with a bit 
set on in ever^ bit position where both terms have a bit on- Its niin 
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uH ii *o -Fcirce bits c+t in cf rtaln dp-iired bit positions* while 
rataining the status quo in all Glhpr po^i-tiDns. 

BotJ^ tha AND and the Ofl instruction have & restriction on thf 
rang* of the value n^ both th* enpreasion to the left o* the cperitiw 
and ^he teriri toihe righ^ol the -operator, H pither is greater than 

32767. Thi A5s#mblErwaistopwtthflriTH^5ALaUANTirYEPR0B. This 
means that the range o+ address sxpression* which nray be operated Lflxm 
Gy these oppralcrg irjat be less thani&flefl. Thifi PSitriction occurs 
because ot the way the J\ND and 0^ operatian^ trt handled by the VIC. 

[t is possible to par^ally Aefsat thi-s re^trictiDn. By spEdfyin^ an 

X-6553fil¥ 



the value af K may be in the range of 32765 to 65^36 <t640ft - tFFFF). 
Y must still be in the range of ft to 32767. niis reeults in ANDing 
the *ulMibitv*lufaof XanflY. I* both X and Y are grsatartfian 

3Z7i7, there is no provision -For sutcessfully ANDing or ORing the tvn 
valuer nan address e:«pressiDn. Remember that BY " V£X and HY = 
Y!IX. 



LDgicilWl" 

The logical OR operator causes the result ot the evaluation of 
the KprBiBiDn to the left □■* the " V to be logically OR'ed with tho 
term to the right o* the "%" . The logicfll OR operation compares the 
two terms of the pperation bit by biti giving a result with a bit set 
on in evrry bii position wfipr-^ either terjn has a bit on. Its miin uie 
is to force a bit on in certain desired bit pcsitionsi while retaining 
the status quo in all other positions. See the pre^ojs section for a 

deatriplion of iimttaticns L^ior thr use of this instructian. 
Bxpnvtion evaluation 



As haa been indicated in previous sectionsi several terms may 
bi unbirtid into an ilgebraLC GMpreseioni the eventual EvaLuationctf 
which wtU result in the address specification. There «re several 
features of the evaluation algorithm w^ich must be understood for 
pTDpflr uce o4 the jlgebnic capability. First, the order of 
evaluation is not like BASIC. Hcrei the expression is evaluated from 
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left to right, regardless of what operalops ipptip in the e^rortssion. 
For eHainplep the evprenion: 

would bsewlLiflted in the following way: The address of LA would be 
AKD'ed with the value 1 . The result would be added to ths iddrssa of 
GH. That result wjould beOH^edwith lec. The result of that 
operation woulO bP divided by the address o^ IJ, The firal Riassage of 
the expression converts negative ei^pression vjlutE to a two^S 
complement value by the adtfitipr of i553d to the negative value By 
way of ffj^ample: 

-I = if^fp, _2 = tppjre, -256 = »FFM, and -257 = tFEFF. 

Finally, expressions which result in values greater than »FFFF 

C4S53A} are made modulo 6553(J, For e>ramole, 65536 becomes ?, 6553? 
becomes 3t etc. 

CcMiplw equitians 

For- those who wish to use more cofliple]^ equations thar can be 
handlEd Qy ejipre^sinnE which are evaluated strictly left to right, it 
IS possible to accoinmodate them hy a serieE of EQU'S which themielvSE 
arp expressions. For P].ample, to represent an equatinn such as' 



(B^C- (D/E )l*^FiG) 

you could write the tolinwing code: 

DE fiQU D^E 
FE EQU Fas 

AB BOUBtC-DEfcFB 



Huch more con-pie^ expressions may be represented ,n a similar fashion. 
The toein«nt field 

Comments a^e entered wi the etatemtnt line b? skipping at 
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l«5t or* 5pi«4f1erth> operand field he^ora toying tha zomm^nX. 
CommentH ar« not illDwed or ByTinBtfucliDns which dfl^iiw liipm 
■■tpings. Commtnts anr i^e^uJ ^or documenlition but Jo tonsjm* mer^DTy 
ind 9D ciuse ths number o* statements per sagment to bt smaller, 

Vftiiing Bultipli stginent prograBs 

To write programs which drr toe long In fit ir a single 
segment, there is onl^ ore requirement. AIJ reterericet to lahela 
which occur in Bome other segmpnt must have an EQU included in the 
segments which reference then,, n 15 therefore nafPasary la acG«mblfl 
the Mgment with the -mlLarilly occirning lahel before a tinal assemblv 

Of the re+erencipfl stgmtMs. 

Becauee The Asgemhier keeps tra^h of ttie ioHtior caunlep 
Between segment* it is not necessary to iixlude an EQU *t the 
beginning of each iubcoqusnt Sflgmpnt to fie+ ihe tocalion cdunter. It 
will, of cource be necessary to set the locatlnn counter at the 
beginning of the first segment. The default initial value of the 
location counter icfl, 
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Thete next chapters will attempt to ixpknd uqon the 
information found in the VIC-?* Programmer's Reference Guide (PPG^ 
The- PRG should bp considered an indispensible refEreine looL In it 

you will fino complete flpscpiplionso* the various special fiirwttnr 

integrated circuits which mirte the VlCihe powerful computer it 15. 
Also included 15 information on the VIC's memory orgamzationand the 

"ternir routines and how to uss them. 

This chapter will provide the machine language programmer's 
perspective on graphics general ion. Joy stick and paddlp usage and 
»urd gerwratian will be covereo m the following charter. The last 
chapter will covwr some orf the internal programs contained in the 
VlC's ROM and the ffieans by whi^ you can msKe use of them. 

Custom Duracters 

The Video Int&Hace Chip IVIC^ aHen ^hich the VIC W9S namtdr 
35 ttie electronic machine, the integrated circuit within ttie VIC 

whichh among other things, causes patterns ta be displayea on yOur 

video screen. It is also Hnorfn as the fi56fl, or or some mactitnes, the 
■65il. The VIC chip IS connected to the ^582 and the RAM and POM of 
the VIC via the addressi data and ccntroi bUGses. Its regi-sters ape 
wired directly to the aiSdrees busand may be wrmen into and read 
from by any program rianning on the 6502. The registers occupy the 
addresses >'9«ee i36H^} to l^fiflF (36875). 

Vou have no doii^t noticed that each character which is 
displayed or your e^retn is a composite of up to i4 dots srranged in 
an e by S SLodi. The information which Cescribes the characteristic 
dot patt&m of e^ch chapict&i- is stored in the VlC's ROM. 

A certain section of RAM is reserved for use by the VIC as 
"screen" memory. There is one byte of screen memory reserved for every 
Character positicjnon the screpn. Since there are 22 fnlumns and 23 
rows there ire 594 bytPs of screen memory. When data is stored into 
screen ntemcry it gels translated inta dot patterns by the VIC chip. 
The VIC chip interprets eacfibyte in screen meinory as a code which it 
has to translate to find the proper pattern of dots to put on the 
screen in the corresponffing screen position. 

The BASIC "PPINT" statement causes "scrson ccriee" to be 
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storpd in s^pen memory;, Itis pDBsible ilso to POkE sct&m codes 
inlD Bcrfisr. n,emDrr. Machin. iangL«ge programs m^y Mors screm COdea 
into screen metKory, A mde slnred in ths first posiiior of Ecrien 
mflmory reprewnts 1h* charactsr ta bs diepTav^d in the upc^r-lefi 
corrwr of the screen- The 2Znd positton of screen memory contains the 
code which PBortspnts the character which gets displayed in the iJDwr 
right cprner o+ the screen. The Sftith position of Jensen nenrnTT 
corrtains the code fcir the cn*racterin ihe lowerrigM corner o* the 

The VIC chip automittcslly and tortirajdly scans -tris screen 
Jfiemory, getting one scraen tode per scre&n locitton and translates the 
screen code into an eigftt by eight dcjt paltern which it then sends tc 
the s-ideo output port to be displayed. In append ik D of tht FRO there 
13 a table Df «reen codes and the corresponding chiracters which net 
J^^lt^^K^H™ ^''«^^^^ta^fl1^f^C^a'^i^*ers which are burned into 

The screen codes are actufllly an 3nOe>[ into an S If S pattern 
table. ScrsencDflesmay hdve any value in the panDen*e-255 There 
';^*^''^^°'* ^^****'''^^<^^^^''*^^^''^^hith^ay be displayed on a 
VlL-^e SH^een at any one tiflie and 25d entries in the pattern table. 
.^ J^;;/''^P^°^*">'*^*r^lf'*t^*n you hold Ihe Commodore anti 
the Shift keys do.^ simultaneously ^ the characters which appear on the 
^creer are from i stcond character set. One character set iiontains 
Lpper and Io*er case characters and the other contdins upper «^ ird 

pL'^1" ''^^^r^'''^' '^^" *^ ^^ "^^ ""^ 9 " S patterns stored 
in fiOH and the VIC chip can be "Switdied" between the sets. In fact, 

the VIC chip can be switched between se^-erafcdJHerenUsbHso^&K a 

fltoi^d''^' RAH ^^"^^"^ '" ^^^ ^"^ °*^^''^ ''''"^*'^ ^^ *^^ programmer and 

Creating a pattern tab ]e is ho^ cu si orr characters ind bit 
iFnage graphics is accomplished. The pattern tables consist ai 256 
«l5 Df palterns. Each pattern set hjE eight byle^. The i& « a 
Oitterns ta*te eight hytes of data to describe each pattern. The first 
byte rsgresenis the tcjp row of dots in the character. The second byte 
represents the ^etond fraifi the top ar« so forth. A bit tufiwti on m 
an^ of the bytes will cause tTae corresponding dot on the screen to be 
Uiuminated. The screen dots are also called pi.fels which comes frqm 
picture elements'^, 

Thestandard character sells stored m POM slartjng at 327fiS. 
The screen code "fl" refers ta the fir-st fl-byt^ pattern, that of the 



character "T. The second character tn the standard character HOK 

startsat 3277fi and le the pattern for the letter "A" (screen code 1). 
Hv*ry eight bytes, another pattern is stored. This goes on for 256 S- 
byte patte-ms- 1>ie patterns for screen codes i?8-255i are the 

"reverH" of the first tZ3 pilterns. That is. where a bit is on ir 
onsp it is off in the other. 

Screen nemory starts at either address 768* (HEM) if you 
have SkorlesB memoTTr or ftl 4e?d lH**ftHf j^ou hiave more than SK. 
The first byte of screen msmor y holds -^e screen code which causes the 
copreBpowling 6 by S pattern tobe displayed in the fmsi column of 
the first row o# the screen- The first 22 [Msitians of scrten meniDry 
correspond to the first row of the screen. The second 22 characters 
corresporid to the Hccnd row arfl sa fofth. 

1+, for example, the screencode "1" was found ir location 
7iefl on an unexpanded VIC, the VIC chip, s*t to fi™i the S x 8 pattern 
tabic Btariing at 3i7*S, would, ir its tDntinuil wan of KPe#n 
meniDry. find the value 1. multiply it by eight to find the 
displacement into the pattern table. Sight plus 3276S is 22776. It 
would atari at thit iddrBas Building t^e dot pattern to send ta the 
video screen. It tinds the following eight bytes of data starting at 

aifla- 

addr dec heji binary 



32776 

32777 

32778 

32779 

32766 

32781 

32782 

327B3 



24 lie 



36 «24 eeieaiea 
£i 442 eiaseaie 
]2<^ 47E aiiiiiia 
66 «42 eieeaeia 
66 t42 eiaeeaia 
66 *42 ei»Bee]o 



8 «Be Bfleeaeea 



If you IddK at the above pattern of on^s aF»d zeros, you will 
hi ah\t to see tfiB shape of the character "A" formed by th* ones on 
th« tjKkgraound of zeros, Ml ot the chiPicttrB' shapr^ are forintd in 
the same fashion. The character* you form in your program mutt follow 
tht came rultfi. 

The inftnTii ition to tell the VIC Chip when to find the pattern 
table isstoredinthere^isteritlocatiDnlMeS 136SA9). The low- 
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order tcur Bits lor low^-ordernybbJe) cont-nlthB Mlection of th# 
5i>[*een pD=5ibiftcharart*rMtUblot. Thp mMhoO of seiecting thest 
possible areds is 45 follows: Bit5 S-Ap Ihe low-nrdar nybblE.o* tHi 
data storeri at 3*8i9 dpfiw wt^ich irea of memorip is to be used for Ihe 

thararter pattern table. The High-orilernvbbLe tf Us the VIC chip 
whera scrten mBiPory is lociled- More about thai lat?f. The iollowing 
table tpivfls the si*[ teen possible values the charicter-tlhlE ulict 
bite may have and the memory addresses which th?y cause the VIC chip 
to use for the character patterns- The °k" in the first halt of the 
byte means that portion of the byte does net i4*BCl the seliftiw. 



%x6 


seeSB 327*8 hJomiBl Upper Case/g 


ixi 


49469 


33792 


Peuei^« Q-f abcue 


fx2 


93869 


348Jd 


Normal UC/LC 


1jr3 


*BCe9 


35640 


Reverse o-f above 


«m4 


f^ase 


3£S£4 


Unauai lab1» 


«xS 


■«94«e 


37888 


Unavai lable 


IxA 


9?Bes 


3B912 


Jnavai lable 


*!<7 


s?4e9 


39? 36 


UnaUil 1 3b^& 


t>L8 


lee^e 





Kot pscoranendfrd 


%^9 


- 


- 


Unavai lable 


%rfH 


- 


- 


Unavailable 


»(B 


- 


- 


Unai^ai labLe 


a>LC 


«iea6 


4fi9A 


R^ 


«1<D 


»Mee 


51 ?e 


PtfW 


ixE 


msee 


61 AA 


R^^ 


*y:P 


ticea 


71 AB 


RAM 



A machine Ungjage routine to acconipliah tti-e switching migtit 



be: 



SU EGU tec LOC 4996 
SA EQU *90 LDC 5120 
SU EOU SflE LOC iSH*! 
SIJ EQU *ftF LCC JUS 

LDft 3*3*9 GET OLD 

rtJD tt*Fe CLEAR LOJ ' SA^E HIGH 

ORA *ietJ SET LOJ NYBSLE 

STA 3*9i9 RESET 
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Of courser only nne of tti« S-U EGU's would be vistdp dependirkg an 

Which irea ctl RAH you wanted to use for the nrw prDQracnmed chcncter 
set. All areas which you night use for your programmeij character set 
Piust be used with some ttiought as to the consequence s_ All -four areas 
ar* suitable but ttiey all falL within the memory apace o§ BASIC 
programs on the unexpinded VIC and A%96 is where the screen mecnory is 
[yi the expanded VIC. To use thein in coojjnction with a fiASlC program^ 
it will be nece»<ry tc modify the BASIC poiinters which identity the 
^tart and end of BASIC progran memory space. These teOinipLies are 
BpoIIiEJ out in AppendiK f'. 7U81ean irrter»«ting location for 
chardCter memory because when it is speafled, the first 128 
characters are lAer definable but character codes ^28-25!} cause the 

VIC diip to select the standard upp&r case and graphics »t. This can 
be an advantage when you wi^ to have both prDgraininable charactK^ and 
ihe standard character^' It can be a disadvantage if you are ming 
the bit-Hiipprd graphics techniques Bxpluned ti»lDw^ 

To create tfie rtew characters i\ is necessary to build a set of 
S-byte EMttems in the same way the origina] set is constntcted. It 
is not HHces^ftry to rEservE a complete 2*43 byte blocK of memory for a 

complete 256 characters if you only have a few characters you wish to 
ever see on -the screen. Hcweveri yau may not use more ^an one sei of 
characters at a time. Once the VIC chip's register at 36669 it9^^^} 
has been setp the entire screen will be gene-rated using the character 
patterns, found at the specif i»d pattern table area. 

Altsmata Screena 



Having more than one screen in me mory can be a nice feature 
for creating special effects or saving display informatian far later 
usi and cThpr uses the f ertilt jmagnitiwi can devise. Rapidly 
switching between two screens can create the effect of having « 
^oregroLTtd and bacKground. Whatever. The addressot where 

the activr scrEin is must be stored mta address 3686? along with ^9 
character pattern table address. It also has a component in address 
3^8££. The pftmtSs u-f stttiilg up alternate screens is less than 
straightforward but it still is manageable. 

The starting address oi screen namory has certain 
restPictions- It mistbe an even multiple ot 512. This is awther 
way of saving that the low-order byte and the low-order bit o-f the 
tiigh-order ti^fte of the address of the start of screen memory imjst all 
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b-e #'a. FLTtheprftorfl, ihe high-cjrdep thpps bit^ o* ihs iddress mus^ be 
2ero5. The h;ighe^t addrE^^ which may thfire-forE be dssi^ned to serein 
memf>ry i« Sflfll llie 09## 0046 in biniry, or(lE9fl inhex or 7ifie 
d«din9l- Df ihe 1^ bits cf t^e iddr?^^ of ^crten mBmory-i cnly -foL^ 
bits may be anything other than fl. These tour bits, bits 12-5, are 
tftfl bits -which must be scored in the Vie chip's r-pgisters to teU it 
where tc find bcrten merriory- ais 12'!ft get stored in the £-^ bile o* 
location 3636^. The f bit gets stored in ihe 7-bit of locition 36afifi. 
It's a liftlt CDm^iiicat^d but a simple set of assembler statements 

viU inahv the Drograirimer's job easier. 

In the foUowing program segniBnt, ADR is the symbolic label 
for the address oHhe memory locatioowtipre your alternate screen 
will be. ADJ is the value computed *r(jin ADR EUCh that bits iJ^lft Oi 
ADR end up in the proper bit positions i6-1i of the low-orfler byte of 
the generat&d addrtss, with alJ otherbits turned o^f (dividing an 
address by l#24 is the same as shif-ting all the bits right Ifl bit 
positions and multiplying b^ 16 is the equivalent of shifting them 
back to th* left four hit position*), AD2 is Itie value cDJnputBd to 
put the 9-bJt of ADP into the high-orden bit of the low-order byte of 
AD2. 



ftDR HOU *i9ee 

ftf>E EOU ADR/lfl24 

AD2 EQL ADR/4 

LDA 3*8^9 GET OLD ^MLUE 

AhJD #fSF TURN OFF SEL BITS 

OW «ADl SET SCREEN SEL BITS 

STA 26B69 

LDA 36B66 GET OLD 

ANO *7F TURN OFF ONLY h 1 3H BIT 

□RA (MD2 SET SEL BIT 

STA 36S66 



This wiil mjfK if and only if the address spa-cifiBd in ADR has 
its 9 low-order bits and Its 3 high-order biis off, as required. 

Dfher-wisB str-ange resultH could occur. 

Some other system data fields msy have \g be modified it you 
arc using the operating system of the VIC to affect ifie screen. The 
byte a-t location £43 tells thtf operating system which page the screen 
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resided on. 

AD3 EOU AOk/256 
LDA mU2 

STA AAB 

It all that is required- There ire also 21 bytes o* screen-wrap 
irtformdtion (tells the operating system wnicn lines wrap around ontoi 
the ne]<t line like in long BASIC statementa) B-tored atlocations 217 

tD ?40 which may need to b? saved and rtctored every tima you switch 

screens. Saving ard restoring this ir>form ation is only necessary if 
you are using the operating system's icrean displaiy system. 
Bit tddmaabli Oriphici 

Bit addressable or Hi -res graphics are possible via the use of 
the programmable Character featurff. The tBChniijiie used la 
Btr-aightforward. A blocH of the screen memory is pre -initialized to 
contain i atrirg flfB*fluen*iaL screen codes (the Jirst positior of 
screen memory contain* a ftf the second a Ij the third a ?iet(,^ The 
screen ffiemory is not further modified by the program creating the bit 
addreetable graphics. The character piHshns (in the RAH character 
pattern table which is addressed by the VIC chip) are modified by the 
program instead of the screen memory. That is. the bLock of high-res 
screen memnry always cofitains the same screen cadet, tfie indejtes to 
the pattern table. The patterns are modified a bat at a time by 
conputing the proper bit position in ths proper 8-bit row of the 
proper character piltern. 

The size of the hi-res bloc»< is a fi^icticm of iivaitible 
memory. The number of character patterns necessary to have a 12S bit 
by 128 bit hi-rcs KPcen li Z56. That would be a 16 by i& blacH of & 
X « characters, 2^6 chd.racters take 2B43 bytes of pattern 
infarm^tion. To bit map the entire screen,- it would t^(e 23 n 53 or 
5**^ distinct programmed charsclers. This is moft thm it K possible 
to have active at ane time. There is a solution to this problem, 

hpiiupver; double-high tharicterfi. 



Doiriile-high Efuractar* 

The VIC chyj has the capability of interpreting the cliaracter 
pitlern table as a S h 16 bit pattern rather than S >: B. By setting 
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the low-order bit 0* localion »?fte3 {36^67} to lithe VIC chip iwill tJD 
mate Id gcrerate S do! wjiftf by li JoT high, characters. Tado this, 
sijite&n bytes of character paHern infarmaiuir is processed for any 
given charscier coQe, Thfl tiDlfi 0* tharactsr Ddttcrns must be 
constructed iccordingJy. it ifi imfiartant to rmte that the character 
pattffrn table wsll now have twice as many b^teg oJ information for the 
equivalent number ot character CDdes. A -full 256 character taQLe wLl 
take Ai96 bytes o+ RAM. This is more than it availAblr on the 
uneycanQed VlC. So» 3+ you wish tfldo +uli-wpeen high-resDliJticin 
pJottimip you must have eKpansiar memory. 

The program in Appendix D sets up i 129 x L2a hi-res bloc-H ir^ 

Ih^ cenlsro-f thescreeriand is designBd to allow* BASiCprogram to 
selectively turn on dr n-ff any bit in tha matrix hy aimply poking the 

bil positions o^ the X and V coordinates into 7erD page memory 
locations and setting a jerc page inflicalof 5Wit.i:h to lell thE progrim 
whether to turn the bit on or oH. This is very mixh hKe the sample 
program m the PPG except it is written in machine languafjE and runs 
many inftny times ds fast. 

Color contrail 

There are tour lands ci cntcir controls in two categcries. 
Bnrdsr colon re+ers to tie color Df "the screen around the outside &f 
the character display area ot thfi ficreeri. Background color refers to 
the color o^ the character display area ot -Che screen. Foreground 
CQJor refers to thf -coioro^ the dote turned on ^^ith]n a cnarac-ter. 
Au3ihliary color is applicable only fqr multi-colnr mode of character 
display. 

The auxiliary jndbacKgrourd colors may hive all Ifi possible 

dif-Ferent hues. The Border arni foreground colors may have only the 
■firsi eight. 

Code Color 

e - Black 

I - White 

?-Bed 

3 - Cyan 

4 - H agents 

5 -Crsen 





d-Blue 

7 - Yellow 
3 - Orange 

9- Light Orar^ge 
le -Pink 

11 -Light Cyan 

12 - Light Migenta 

13 - Light Green 

14 - Light Blue 
35 - Light Yellow 

Bath border and background colors are determined by the value 

cf the memory l-ocation »?«ftF <36a7'3^ Bachground is set b«ed on the 

value cf th? -four high-cirden bits, bits 7-H. The border color is se* 
m the three Icivorder bits, bi*E 5-8. The renuaining bit, bil-3in 
this location determinBs whether the normal bai;i^r^?u>id/forfiq round 
colors are reversed or not, [f the bit is on the backgroirri remains 
fweri it the color specified in bits 7-4 and the toregrourvd dotft itiky 
vary from fharactpr to character under control o^ color memory as 
described rwiit. H it is off f the background color will vary from 
charictpr based on the values in character-color raeFnory arvd the 

foreground (the dots? will all be the constant color as selected in 
»9SeF. 

The foregrciurd color is set tor each tharader position on the 
-screen. There is a 59& byte blodt of RAH reserved for the purpose of 
telling the ViC chip ^hat colors to assign to the 586 screen 
positiom. Thiaareaof RAK stirts at l?&9e (3£4ee) for systems with 
■141 to Sk of RAM and at %^W [37398) for systemis with more than 8k. 

Each byte d color menory has the ^Dreground color code in the 
low-ordfr three bittj This allows eath th*ricter position on the 
screen to have its color selectable, 

Thfl h^gh-ofder -four bits are insignificant. The value o^ bit- 
3 IS very signi-Flcantt however. It selects the mode o-f interpretation 
cf the character pattern. The eight byte bit pattern array +of each 
tharactep code can be interpreted hy the VIC chip in two different 
Vpiays. So farf i*ia have only looked at the normal or "hi-refi" moOe of 
interpretation. The second mode ia called multi-color node- Bit-3 of 
Bicd bylf of color memory will cau« the corresponding chapactpf 
position on the screen to be generated in hi-res mode if the bit is a 
*. It will cause multi-color to be in eftect #or that character if it 
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is. a 1. 
MtUti-calcr iHd* 

In mjlU'CGlDT mKlCi tr>E ci^ht bylrs cf pattern irrfDrm4tion 
are rtot leen as eight rgw-^ af eight dots as with high-rts. The »ight 
bita oJ tach row are setn fl5 four two-bit colpr codes. This means 
trtat in multi-cDlar nihOdE the ch aracters tlt5play*il pr the screen 
consist cif eigM row^ □< four dots each. Because the characters arp 
ihe «ame swe and can be dispUyed a1 the same tim# as rtigh-pet 
characters, thp fcnir horiianf al dots in each row are twice as wide as 
the £i.ngle width dots of the fii-res characters. Another way o+ saying 
this is: the multi-CDlor mods d* tharsctprdispUy 150* hdW the 
resolution in "the hdn^ortal direction as the high-res mode, 

Uith this modep eac4» character riisplayprf may have <jp to four 

dLffsrint tolors, Sinra thf mode Mlertion bit is sellable fnr fvary 
screeri pucitian. cnulti-calor char-acters may be miKed with the single- 
color characters dt the screen- 

The two-bit color cedes whith fle^r* the colors and are found 

in the pattern table am: 

#ft - b4ckg round 
fli - border 
1ft - forpg pound 
11 - auxiliary 

gvtiTipl?: 

Location (9*eE l36a7S) which controls the selection of the aui:iLiar/ 
for dU chirsrlers contains 170- This sets au^iiliiry color to red. 



code of ii contains the value lw& (>r>!i(!r 14H) wh^re k indicates 
Einimportant. Signifies black foreground- color and multi-folor en ode for 
thf firit Krpen character pcrsitioniafl* in bit positions 2"* for 
O^idt and i in bit position 3 for multi-color. 

Locations 71£@ through 717S* the character pattern definition bytes 
for character code 4p contain: 

llli HU tFF 
1814 leie tAA 

ftieieieiss^ 

ftftei i«ii«]B 
e^ei leiitiB 
eaei leii *is 
0«ei leiiiiB 

The character which will appear on the screen in the upper 
iBft corner will fiave i red line icross the top ( four double wide 
dots each with the au>riliary color d^ red)- It vill have black line 
under the red line Ifour qapp5 of 16 indicate four foreground color 

dolt). Beneath that will be a blue line ( f nur bords-r folor Aatii. 
^neath th-at will be a magenta line ( four codes ot W signify 
background color). BbJow that will b? four horircntal lines ot 
rrragentaf bluej black dnd red going from left to right. 



If yoj understand why all that is- truv theri you have a 
grasp af color gaphits on the VIC-?ft. 



good 



LDcatiDn *9fl*F (36S791 which controls ths selection of the background 
color ind- the border Lolc:f contains *4E. This sets the bscl'grQiind 
color to magenta and the border color to blue. 



Location 768ft (ilEflfl*, the first character position of screen memory 
contaam a ft which will cause the VIC chip to *jnd the character 
pattern definition at location 7li6, the first pattern, 

Location SSISft tt?&te>i the color-code table positievi for a scrten 
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SticKfi AncF Sound' 



Joysiida 



Mos1 incut and outpirt Id and from "the Vic-2ft is dccompli^ed 
with -the assistance of twa [mlegraied di^cmts, the £52? VersaiUe 
InleNace Adapters iVlAi). LiHe the VIC chip, thew "two fleviccE are 
ir cDirnnunicdticn with the 6thflZ and the ^OH and RAH dfivic?s via the 
address, data, and control busHS. The funclicnir^ q^ these chips is 

under cantrol oi their six teen internal addre^uble registers. Like 
the VfC cPiip's registers, the VlAs'rEgislBfs nay be Loaded ard saved 
hy pragr-ams running on the 6>S92. The 32 registers occupy the 
addresses I9il8 -i9l2F 137136 1o37t6S). 

The VlAs are very pwiwer-ful and camples devices. A camplete 

dfscnplicn o^their u^e is beyc>r>d the scodp o^ ihi^t^iit. We will 

present the general means of doing input ^d gutput throijgh the VIAs 
and the speti-fic means o-f prngramming *or joysticHand padcfle tree, 
Per i wmplete tschmcil d:E5trip1ion of advanced irsage »na pragramming 
0^ these d-evicesi you shmjJd acquire the t«chnica1 spetifications from 
H05 Technology. 

E«h D* the 6522'^ has two jnptrt^outpirt ports. Each port J5 a 
set n-f eight electrical connections between the data bus of the VIC 
ind wviPld outside the VIC. The poft^ are cdUed port A and part E. 
Eich port has an associated data, direction regisler IDDR) w^iffi is 
u^ed Id set the I/O port's eight lines to Either inpul or output or a 

The DDR -for VIA til. port A, is found at address 1?H3 [371S?>. 
Gich cj* the port's eight lines to the outside world may be configured 
ii any tims to either accept input in the *orm oi 5 vollage signal on 
to produce outjiut as a voltage sigraL All lines represent a load of 
one standard TTL gate in the input mode and will drive one standard 
TTL load ir the output mode, 

The I/O lines o* port A, VIA ttl are designated lines fl-?. They 
correspond to Ihe fait positions B-7 in. mernop^ bcjiior i5tU (37137). 
Receiving input from or pytljrig output to any intfividuil iine is as 
siBiple AS reading fmm or writing to that memory location, Firstp 
□e-*ore atlLaJly reading or wfi^ng the data, it it rece^sai^y \a tel! 
the VEA whith lines are cannerrted to input devices and which are 
connerted to output deviceg. 

The DDR'^ eight bits corresporrf to the Bighl bits 0+ the I/O 
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part. To select any given line as aninput line, the corresponding 
bit of the DER must be set to a 9. To identify a hne of the port is 
an output lincp the c-orre spending bit in the DDE must be set to a i. 



«JIA M] 



^lA 1H2 



DDR 1^ «9n3 


(371391 


*?123 


^371 55) 


Port A »911i 


^37137> 


*5t2i 


^STlSS] 


DDR B fP112 


■; 37136) 


*9122 


137154) 


Port B *9nfl 


<3713ri> 


*^i£e 


^37352) 



Joy^ticUs have *ivB internal switches. Theg al?a have a source 
of 5 voit pov«r which the si^jtches direct to the apprc^iste cms of 
the connector. When the joystick is tipped in one of the four 
directions the switch for that direclAoni^ closedr senfling the "aV' 

signal l-f-5 volts or a binary i) to the proper connectijr oin. It the 
joystkk IS moved to the diagonjl oosition, both the switches are 
dosed. The nther switches send the "off" signal tft voUs or binary 
ft). The fifth switch is the #ire button. It's signal is a a urless 
it is pressed* when it becomes a 1. The comeclor pins are directly 
wired to the VIA I/O pgrts. There is a "TOP" diretlion indicated on 
most joysticks. The switch associated with that direction is connected 
tflbit-2o* VlAttl, Port A, "BottDin", then is bit-3 o^ VIA «1, Port 
A. "Left" IS bit-4f same port. The fire button is bit-S, same port. 
■Right" cs attscned to bil-7 cf VIA H2, Port B. 

SOf Id sense the direction o# the jay stic^ and whtthtr ihe -fire 
button IS being oushed, two J/0 ports have to be input to the orogram. 
Port An* VlAtti IS used for the send port as well as the game port 

and Port Bof VlA#2i5 uwti+cjrKQybDardinput aswell as the game 
port so it is advised that if yo\j wisti to use either of those devices 
aJter doing joysticH input that you restore the original value o* the 
DI^Rs after doing your /lysticK reading. 

The tollowing prograiFi segment will save the DDRs, set them for 
ffystick input, read the Joystick switcties and save the switrJt valuta 
ti bits set in storage location e. 
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INPUT 



DDft2B ECU *9122 
IGIA £0(J *9nj 
102B EflU 593^0 

LD>; DDRlfi 

LDY DDR2B 

LDA *HC3 

STft DDfilA 

LDA lOlA 

i^D #t7F 

STX DDRlri RESTQHE 

£TA 1>DR2B 
LDA ID^e 

AMD nafl 

ORfi 9 

STrt a 

STY [JDR2B RESTORE 

RTS 



BITE 2.3,4 



FORCE 7 BIT QFF 



INPUT BIT 7 



FQPCE ALL BLTT 7 BIT DFF 
BLEND UlTH REST 



Thsre may be t*o game paddlBS connected tn the VIC at the same 
time. Each paddle has both a s^ilch and a value which uanes ac Ihe 
piddle 15 rotated. The vanaWe value may have a value between ft and 
255. The switch will he either a one or a zero. The X paddle-'s 
variable valw may be read from local ion (99flS [3dS7Zh The Y 
paddle's variable value may be rean ^roin location »9fle9 <3A&73), 
These ar^ locationa within the register set n-f the VIC chip. There i5 
no preparation necessary to set up the TEidircf af tJie» values. 

The switch settings of the two caddies is input in the 
identicil mamsr as the switchps of the joysticks. In fact, the 
switch ^Dn paddle X is the same bit, port and VIA a^ the "leff switch 
of the jpysticW. And the ¥ paddle switch is the same as- the "right^ 
switch. The same program as wiE given lo read the jaycticMs ftay be 
used to read the caddie switches. 
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The VIC chip has the additionaHunction Dt providing sound 
effect capabilities. There ars *ive re^sters in the VIC chip whiqh 
are used Id control the sourvJ functions. Saunds are generated by the 
VIC chip and sent to the connected TV along with the video signal. 
The- five registers are addressable hy any program running on the VIC. 
TTii-y are vs-ry Mm pie to prograin. 

The volume control register shares location 3^378 (l9eeE> with 
the auxiliary color reoister. The volume control je set in the low- 
EJTder four bits nf 36378 and the auxiliary tolonndicator 15 in the- 
high-order four- bits. The volume may be set to a value from a to 15, 
fl setting the volume off and 15 setting it at its highest setting. 

The vpiumt setting controls the volume of all foir "voices"; basa^ 

alto, soprano, and noise. 

Ei(h voice IS independent]/ ctintrollatle as to its frequency 
but not its volume. The high-order bit of each voice register may be 
conEidered as a vpice "switch". If the bit saon i has value of 1 ), 
the voice is activated. If it tsa fl or o*f, th& voice is 
deactivated. The remainder of the registeri the low-order 7 bits 
control the freciuency o* the sound generated. 

US TV %etB, INTSC standard), differ from fiumpean sets in the 
frequency range of each voice. All of the voices may be heard 

Eimultarieously if they are all switched on or any combination may be 

on at any one time. The gereral formula for equsling ffequenc^a from 
regtsten values is: 



FrEq = Clock /j 127 - » 

where X is the 7 -bit register value in the rar^ie of ft to ]?&, 
i27|. the formula is: 



ForX 



rMq = Clock/ m 



The folowing table summarires the various voicesi their "CLocK" values 
and the memory locitions of their rcgittprs: 
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"JCn te 



addre&s 



cl&ck 
NTSC <US TU'sJ PAL (Ejropean) 



Bass 3ie7'1 *99BA 
AUa 3*875 i9BeB 
Sprno 3^67* t9B0C 
NolEe 3*377 *9eeD 



39?S 

7?9e 

15980 



17328 
3464e 



The "theory and technique-s oi music synlfieEis and ^aund effects 
15 beyond the scope of this isat, but bctfi the Programmer's Referante 

Guide dnd Ifie VlC-2e liser^s Guidp prnvide speup ir-formiticm on creating 
sound effects dnd musical Hfecls. 




VIC Internals 

Pie VlC-2ft comes with i&K o-f ROM In wriich the internal 
opEfiting pragnms reside. These are the programs whuih interpfet 
BASIC programs and which cantrol the input and output flevic&s vhiiih 
came with the VIC and those which can be added. This bloiJ< nf inpmtn-/ 
extends from tCHfl TOiFFFF, Some of the intemii programs fiave besn 
dccuiiLented by Coinniodare in their Prcgramirier's Reference Guidci Thpse 
are what ths^ calHhe "IfemaJ" programs. The> deal mainly wEth 
input/output (I/O) prtJCES-sing ht ihe VIC- This -Ceift will not attempt 
to dupiicite the infcrifialiDn pu^ovided in the PRG, i1 is once again 
s-trongly recGmmended that youobtair a onpy D+that referewe WCrU. 

There are fnany other subroutines induded in the VlC's ROM 
v^hich are not covered in the PRE. We will attempt to pPQvide 
in+tjrmatiiiA on using the more UbHu) d* thnsfl. Ue will iIsd present i 
ILst of the Entry points of the remainder. Those ^n^tch are riot 
dlscirased in detail may be decndsd wltfi the Deceder for ycup 
inspe-ctian and understanding. 

Ari^mBtlc routines 

Aa BASIC processes your arithmetic ei^presians, it uses a 
variety of machine language subroutines to dn addiiioni subtraction, 
eitporiBntiatiDni trig funclionsj etc. These subroutinPS are available 
to the machine language program for accomplishing the same fuKtions. 
They are all fairly sliriiliap in the conventions 64 Ih&ir use, i.s. the 
means of passinq parameters, getting the resultst etc. 

Numbers in BASIC ira^ be expressed as either integers or as 
"-Floating point" numbers. IntB-geps have no frartional comporwnt- 
They are sixteen bit signed numbers which may have the range o* 
32767 to 32763. Negative nfljmbers are ei:pres3ed in twn's complement 

notation as diHusseri in chaptpr -four, 

BASIC does all its cDniputaticns in floating point mode, 
floating point numbei^ have fractional components. They are composed 

Of three pnrtionbF the expanenti the mantissa and the sign. The 
exponent occupies one byte and itsbmary value is 126 greater than 
the exponent being expressed. The value of the expressed ewpanent is 

the number of bitsv^hich the raafriissa needs to be shifted. Since the 
ejiporent expression is stored in "ej<cese 128", the range cri actual 
exponents is -lES to i27 (stored as fl ta 255). Negative ej^ponents 
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mean the mADlisaa (is slDTSd) neadB to be shifted tcr the right and 
po-sitive exponents ineans the mantissa needs to be shifted to Ihs iB^t. 

Ttie mantissB is a Idut byte binary value P It is 4he shifted 
value of the number to be e^pressedi This is ]ike scientific notatign 
as used iri physics and cticmistry. The decimal system of sciEntific 
natation would eHpreas ^hs rwmb-er 12674546^7*5 aa 1.2&7454S765 > il 
raised to the 7th power. In BASIC you would see this number printed 
as 1.3 e 7^5*67^5 Efl7^ A decifnal e>[panen1 of 7 in scientific nola^iDn 

msans iht decinial poin1 needs- to be shiHeb 7 places 1o ths riqht^ Or 
that the mantissa needs to be multiplied by IS raised to the seventh 
power. 

It wonift. ths samp vty with floaling poirt numbers E>:cepT the 
mantissa is in binary and it n?eds to be multiplied by 2 raised to the 
po^ve^ of the eif portents Hultiplyirig a binary number by t^o is the same 
as shifting it one bit positiun. s^. 6 = ^n^ eue and 1£ = «^ea 

CBk BASIC always normalizes the mantissa be-fcre saving ii in 
the -floating point format. This means that it sbifts it so thp 
leftmost bit is always a one bit. The nunaber 6 (binary value = «eftft 
ei 14) wnuld be shifted so thai the nnrniaLi^ed: mantiaea i^jould bs U00 
69^6, W^ii 90CS into the eifDonent field is 12s plus the number C3f 
significant bit pcsitions in the ciriginal number^ flSflft ftliB has three 
significant bit pdsiIidts, gd the e^iporwrrt wchjIeI be 13!. 

A few e>[amples ^ill bp helpful. The binary represenitaticn of 
the floating point storage of the number & is: 



teae asn iieo ee^ 

131 i92 

«83 see 



»9«a 6399 

tee 



98ee eeee 
»08 



&eea est 
ft 

«9f 



exponent 



lairt i 5sa 



The typwient d( J3t fepresents an actual espotient of 3 Ci31 - 

128). ¥du may cdnsid?r th? mantissa as a fractinn with the radi^ 
point (-decimal point or, rather, binary point) just Id its left. The 
amount it must be Ehi+ted Id get DacK to i its actual ^ilue i* three 
bit poBitions. In ether words-i the radi!* poml must be shifted from 
the left of thp binary number three places to the right. 
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Other eKAinpies: 

The- njmbcf 1 (3^69 6881) 



iaa8 eaei laee eei 

129 12fl 

t&\ 486 



eQBB Gsee aeaa eB3& 



»9e 



e 



etpoment raant Lssa 

Th^ number ? (&me eeifl) 



10BB eeU 1 
12? 
«82 



J2S a 

488 ^08 



>«8 



e 
tee 



exponent manti ssa 

The nunibep 3 (8^68 881!) 



laea eeie 1 lee aeee 
f82 -tee 


aeee eeae B^es 
a 
«eB 


eaa& 

a 

«afl 


eeaa eeaa 

8 


ftporrent 


man 1 1 ssa 






The rrumber &5 Cfllflfl 


eeen 






laaa em laee asie 

135 1^8 
*a7 482 


aeea eeae Bsaa 
8 
saa 


eBBfii 
a 
«aa 


eeae eeae 
a 


es^pcnerit 


manti ss& 







The sign of the number is carried in the high -order bit of the 
byte following the mantissa, [f the sign bit is oni the number is 
negitiv*. If off it is positivfij 
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Thar* ars two floating point accumulators maintairwd by BASId 
FAGl andFAC2. FACl is located at *il-*<?i (97-163) and FAC2 is at 
W9-tiB (]*5-Ill), ThMB two 4cnjmuifttor5 are usrd tor all 
mathematical aperations. FcllDwinri the FACsi a.t >±F fillet ia a sigr 
CDflipariior^ flag. The high-order bit. if or, signifieB the twn FAC's 
are qf di+fffring signa. 

Arithmittc rautlrvs 



The tGllowing rcutinBsoerfcjrni mitfteinatiEJil opsfi^iwi* usincj 

Vne tlDatir>g point accumulators FACl and FAC2 and values stored in 
other memory locations. Each routine ^nay be *xecirieqt by a JSR 
instruction to the indirattd rntry point. REfffrences "to iiieniDry 
Jocattors are frequently commurrica^ed to \'anouB routirips by an 
addreaa contained in the A-rpg iLSB) and tfte V-reg <MSB). Ue will 
refer to this -(orrriat a? fo*'I!ll"l-li 

Hast af the +ollDwing rcKrtines use tfte A-reg, It-reg and Y-reg 
4Gr CDmrniiTTira-tiDn. His an interesting fact -that when a SYS is done 
from BASIC, tftfice three registers are loadecj +rc]rTi memory locations 
799, 731 and 7S? respectively. It is therefore possible to call the 
*allawmg POUtinES ard thnss in the lt«rnil from BASIC by SVSing la 
ttiem B-Fter setting up the three register storage bytes. 




ABQItfiFACl •D7B3 0SZ2tl 

An ASCII string is corcverted to floitirig point format and saved 
in thB FACl, The stnruj mdy be myu/here in memory ind the aDdrv^^ at 
the starting location must be pointied to by the utility string pointer 
at ■22,»Z3 t3A,35). The lengHi a* the s-trimg must be loaded into t^e 
A-pegp 

FAcifoABOi tnimaiitTi 

Thv ASCII repreKntfetion of -^e V4lue in FACl will be sived 
starting at iftlflS Q56) and contmuing uitil a t09 is encountered. 

Hwrnay to FAC2 IDAeC 09949) 

Same as above except using FAC2 and the sign comparison ^ag is 
set- Thie exponent Df FACl is rpturMd An th« A-re^, 

FACl to Hfrmory 4DBD7 <5£Z79) 

The FACi is stored into any five byto memory lucalion, Tfie MSB 
Df tt)B address ejf the start of the memory location is pas&e-d in the X- 
reg. The LSBis in the Y^reg. The high-order bit of the marrtisH 
field ii forced to the FACt sign flig. 

FAQ to FACi IDBFC (S^l«> 

A simple niQVE is performed from FAC2 to FACl. FACZ is not 
affected. 



Integer to FACl - ID391 (MlAl) 

A tWD-hyte integer vilue in forniat-t is converted to a floating 
paint number storefl in FACL 

FACi to Integer *DiAA t?3&74> 

The FACI ifi tonverted to a Iwo-byte integer whith is saved into 

iDcatjons t64pld5 41«#,ie]). The F'ACl is destroyed. 

MeBory to FACI »DBA2 ^6226i 

A fi^e^byte floating point number anywhere in memory is loaded 
into FACl . The address ai the starting werrory iDUtion is in format- 
1. The sign flag of FACI is set on if the high-order bit o-f the 
mantissa is a one, else it is set off. The e^rponent is rettrned in 
the A-rpg. 






FACI tn FAC2 IDCBF (U333) 

A simple move is per-Formed +rom FACI to FAC2. FACi is not 
4*feded, 

Logical AKD of FACl and FAC2 »CFB9 (SS223> 

FACI dnd FAC2 are logically AND«d iDOBther^ ths WBUlt ending 
L^jinFACJ 

Logicil OR of FACi tnd FACZ >CrB6 03ZZ2) 

FACl and FAC2 are iogicslly ORed togethtpf thie result ending up 
in FACl 

FACl - FACi - FAC2 >DV33 Q5379) 

FAC2 is subtracted from FACi ■ tharesuli replacing FACi. FAC2 
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is not Affected > 

FACl - rACi + PAQ tndA 1554«» 

FACl is replaced by the aum erf FACl and FAC2i It \^ necEss^ry 
to stt -thi sign compw +Ug prior ^ calling this rajtlne. Thin it. 
done by SOPirig kxttiors t&A ind C£S 41ft? «nd lift) and storing th» 
result in >£Fp It is ilso mctasary to loid tha A-rtg with the vaJue 
found in %6 i (97). Not« thdt bcth of thasv functions tn done ^y the 
M*n1&FAC2 routine. 

pACi - FACl » FAC2 «DA» SSSM) 

FACi is replAcedby^hepTDOuciaf FACl AND »AC2. The umt 
notes dpply is for the above mutinB. An altsfnate entry point for 
this rciutint isiDS33 (55948). This entry point will execute the 
memeory to FAC2 routine before doing the multiplicatior' 

FACl ■ LOO ( FACl ) »D?BA Q?7««) 
FACl ie repland by the LOG ^ FACl. 

FACl - FACS / FACl IDB12 QAIBZ) 

FACl is replaced by t^e qoutiEnt of FAC7 and }i^AC1. The »me 
notes apply as for iddition. Hovreverby JSfting to *DBftF (54fl79) 
insieiitf Ihe iDaQing of the FAC2 fram namory will b« ucomplis^ied 
prior to dotng the division. 

FACl ■ FAC2 '^ FACl IDFTB 07211) 

FACl is replaced wi^ FAC2 rainvd to th* power of FACi> Bami 
commBntE as for iddition. By using the IDFTS G12^&) entry pointp the 
routinfi to load FACl from memory [itay ^e «:<ecijted prior to Ihe 
exponentiation routine. The Henory to FACl routine does not properly 
»et the sign compirt flag however- Also note that when using thtse 
alternate rntry poirtit the lame ittup of Ifie A-reg and Y-reg must Bp 
performed as per Kem-tc-FAC routines before -caUing the desired 
iriihnetic routine. 

FACl - FACl / It IDAFB (SCtdZI 

FACl i* f*pl4Ced by FACi / 14. 

Coapare FACl And HeeiorT IDC5B(M4lt) 

The A-rtq is ut depending on the resull of the campan bitwitn 







FACl ijvl some -flu-ting point number in a Epicl4iid nwrnnry location. 
If tMy are equati the r#sult is B; i-tf they ire not equal the result 
is IFF G^S). The address of the start of the niemary location Is In 
farmat-l> 

FACl ■ ABB ( FACl > tDCM (564*6} 

The FACl i« rfpld»d by the -ibsolihe value of FACl. 

FACl • IMT i FACl ) >DCCC (M524J 

Tha FACl « rcplited by the integer portion trf FACl. 

PACi - ffiH < FACl h »DC» 6ASTD 

The FACl is replated tty 1hi v^i»* e if it was a lero, by 1 it it 
was greater than zero and by -1 if it was lees than zero. 

FACl - 9QR { FACt ) IDF71 (972«11 

The FACl is replaced by 1h« square root of FACl. 

FACi ■ SXP 4 FACl ) >DFBa(S732S> 

The FACI is replaced by the value computed by raising e of 

natuTil logarithm fame to ^e power of FACl. 

FACl- COS (FACn *S»I (37$5S) 

Ttie FAC! is replaced by the Cosine of FACl ej^presHd in ridiam. 

FACl - 5!H I FACl » iDCSfi SMtH 

The FACl is replaced by the 3ineof FACi expressed in radians. 

FACl - TAN ( FACl 1 >B2Bi 081331 

The FACl is replaced by the tangent of FACi expressed in radians. 

FACI ■ ATH { FACI ) IBMB a&12B> 

TIh FACi is replaced by the arctangen-f of FACI eKprtfiscd in 
radians. 
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Input into BASIC buHf p tCHt (9K28I 

The 88 by1« BASIC input butfvr clartino it 14200 1512) ic 
filied witn chdrictera -Froin tht ktybaard. A TRetu-n] terminates \he 
input anfl ■ »#* signifies the end d* l^w mesuga in the buffer. 

Output alHng to «3-Hn >CB1B <319f9) 

The atiriing address o* b string o* ASCII characters to be 
printed on the screen is set in farpnit-t, Th* B^ng must bt 
terminated by a 



Modi 1 
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^DC 


X 


:< 


X 


iWD 


K 


4 


)i 


«45L »c 




X 


X 


ecc 








BCS 








BEQ 








BIT 




n 




eni 








BNE 








BPL 








BRK 








WC 








BVS 








CLC 








CLD 








CL] 








CLV 








CMP 


X 


:< 


X 


CPX 


X 


f 




GPY 


X 


K 




DEC 




X 


It 


DEX 








DEV 








E0I4 


H 


X 


M 


IKC 




X 


X 


iNX 








INY 








iiMP 








JSR 








l^ 


K 


:>t 


^ 


LDX 


V 


K 




LDY 


V 


n 


X 


LSP X 




X 


X 


NOP 









It X V 

X 
X 

X 
X 

K X A 

X X 

X 

X 

:ii >i >i 

X X 

X X 
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i^pp«ndiK B 



PtgiB-t 



OR^ 


X 


a 


P^ 






PHP 






PLA 






PLP 






ROL 


|iL 


X 


RO^ 


■V 


X 


RTl 






RTS 






SBC 


X 


n 


SEC 






SED 






SEl 






STA 




>: 


STX 




X 


STY 




K 


TAX 






JAY 






TSX 






T5tfl 






TXS 






V(f\ 






Hode% 


. 




J - 


'^cuumulator 


2 - 


Tmniedi ate 


3 - 


2ero 


page 


4 - 


?erO 


piq^jX 


5 - 


Zero 


paee,V 


6 - 


Absolute 



:< X 



7 - AbEalutv,;< 
S - Att5dlute,Y 
9 - inrpl led 
IB - Re1at Lve 
n - (Indirect, XJ 

12 - (Indinpctl.Y 

13 - <lrdirec:t> 



•^ X 



S X 




Dfi^ 


HtA 


6ir«j. 


Dk 


Hti 


Binary 


D»f 


Hit 


Etiniry 


he Ht> 


Slnarr 


i 


ill 


%m iii« 


32 


«2i 


iiLi eai8 


A4 


141 


Bill Bill 


n M\ 


III! IBIB 


1 


IBl 


me leai 


33 


17 j 


fill B»l 


AS 


441 


IJII III! 


97 4il 


Bill HBl 


2 


»2 


i«ifl eiiB 


3* 


«22 


nil iBie 


d& 


44? 


BItB B41I 


PB 4i2 


Ilia 4B1B 


3 


tl3 


BMI iSll 


3^ 


123 


»iii lit] 


i7 


i43 


IIIIHll 


99 Ml 


IIJI laii 


4 


t«1 


eti« eifli 


^ 


«24 


i«ie lies 


da 


444 


BJBI BIBI 


lia 4d4 


aiiB Biaa 


5 


lis 


aeae iiii 


37 


»25 


Bill BIB] 


i? 


«45 


nil «m 


lai 445 


nil nil 


i 


Ufi 


im«iii 


3B 


I2i 


iti« am 


7» 


14d 


iLii ma 


JI2 16A 


BUI BUI 


7 


417 


BHI l\\\ 


39 


427 


IIJI 111! 


71 


447 


«|IB Bill 


113 U7 


Ills nil 


6 


««S 


ma Ei«e 


41 


t2B 


IBll i»e 


72 


44B 


iiii iti« 


MA 4ifl 


Bill ItBI 


9 


«s 


lAlfl llfli 


41 


42? 


nil lill 


n 


44* 


iiai laii 


JI5(d9 


IJ19 Jl-i 


li 


(BA 


«e«i leie 


42 


ft2A 


m\ nil 


74 


14A 


Ilia iBiB 


Lai44A 


nil laia 


11 


il^ 


Bftifi lau 


43 


42B 


m\ iiij 


?5 


I4« 


IHI l»!1 


EI7 iSi 


&119 1111 


n 


m 


BHe 11 e« 


44 


42C 


Bill 111! 


76 


t4C 


aill UBB 


IBS 4£C 


me iiiB 


13 


ISD 


ABflB ]1«l 


45 


I2D 


IBia 13IJ 


77 


44 D 


Ilia nil 


la? m 


BUI 111] 


14 


tOE 


iflifl 11 ]« 


M 


42E 


IIJI lll« 


78 


I4E 


iiai JiJi 


111 Ul 


ajis Jill 


11 


IBF 


a0ii 11E1 


17 


12F 


BBll nil 


79 


HF 


ijia iju 


111 44f 


BUI ]in 


14 


119 


i#ei «BflB 


4B 


431 


Ifllj flBlfl 


N 


45B 


BIB] laia 


112 71 


till Blfrl 


17 


t\\ 


BH1 mi 


49 


131 


nil 1011 


Bl 


1^1 


am iiai 


1J3 171 


nil IBll 


IB 


112 


IBfll Bill 


51 


S32 


eilJ «I1B 


ez 


452 


nil HIS 


114 472 


Bill Bill 


1' 


tl3 


Mil IBll 


51 


433 


nil 1111 


B3 


453 


Biai 1111 


115 473 


nil am 


2t 


tl4 


%%%\ %m 


52 


134 


«ll] l]«l 


ei 


154 


iiBi aiai 


lid 474 


nil ma 


21 


415 


IHl »lfll 


53 


«5 


e»u ejii 


35 


455 


\m iiBi 


tl7 t75 


am tjAi 


22 


%\6 


ie«i lufl 


54 


■13d 


Bill Bill 


fiA 


Mi 


am ftui 


lie Mi 


1113 Ilia 


n 


%\1 


III! fill 


55 


«7 


iMi am 


67 


15? 


111] 111! 


119 177 


Bill BUI 


lA 


«ia 


BflBl 1BI# 


5& 


43S 


Bin Lea« 


B8 


154 


am Jiai 


121 t7B 


nil im 


25 


*1? 


m\ i»j 


5? 


*39 


mi iiai 


e? 


45? 


nil im 


121 i79 


BUI nil 


li 


4 LA 


mi lilt 


58 


IV 


ItJL IIJ« 


PI 


)5A 


im IIJI 


\n%ih 


nil iBit 


27 


ilB 


IMI l«11 


5? 


^38 


«B1I nil 


91 


I5B 


ijii 1^111 


123 47B 


Bill laii 


29 


tic 


eMi ijii 


i« 


*X 


iiiL \m 


H 


I5C 


m\ nil 


124 17C 


am iiai 


Z^ 


tID 


mi nil 


dl 


430 


nil Jlil 


93 


15D 


am iiai 


125 170 


nil nil 


31 


41E 


»ll 111! 


il 


«aE 


i«n nil 


94 


4K 


IIBL LILI 


12d 47E 


111! IILI 


]| 


«IF 


mi nil 


tA 


i3F 


IIJI IIJI 


» 


fSF 


am Jill 


127 ITF 


111! IIIJ 




Irwidt Tht VIC 



P4gtB-2 




luidt Thi VIC 



Pa9*C-1 



he Mr 


Bijriry 


[wc Ke 


Biiarr 


hm at 


Binary 


D« Hf 


BntarF 


I2B1«B 


IflH »» 


IMSAI 


nil Bill 


]f2 4CB 


IIBI 


BABI 


224 f EB 


11 n BMI 


n?m 


IBSB «lflk 


]«l «A| 


IILI Iftll 


193 CCl 


11IB IIII 


275 «E1 


111! leii 


|M*«? 


iiae e«ie 


Id^ M2 


IBia «B1H 


194 1C2 


IIBI 


Bin 


226^2 


nniin 


133 183 


ifet till 


163 1A3 


nil len 


195 jca 


ini 


8811 


227 1E3 


iin Bill 


132 194 


ii«i B]«i 


164 IA4 


\m mi 


m 1C4 


nil 


ini 


22B 1£< 


iiJi Itll 


133 165 


MM «iai 


t*5tt5 


nil m\ 


1W«CS 


111! 


Bill 


2»lfS 


1118 Bl»l 


mm 


Ji«B BUB 


IddlAd 


iflll 111! 


194 tC4 


1i«4 «in 


23i 1EA 


lue ini 


\3i IS? 


IflBfl 111! 


li^M? 


iiLiftiii 


199 *C7 


Jill 111] 


231 %i7 


1138 ini 


134)18 


]m im 


149 lAe 


iltl lABI 


fl|»C8 


me 


eiei 


232 lEe 


nil nil 


137*99 


1B«I ]flBl 


ld?1A? 


iBja nil 


?fll «C9 


m^ m\ 


mm 


nil iii[ 


133104 


]«ae lijA 


]7»«^ 


nil nil 


242 «U 


nil 


IB18 


£3^4&k 


nil nil 


i29 ISB 


laei Jill 


171 1AB 


i«ii iflii 


?B3 Ki 


UIB 


nil 


235 If B 


nil iflLi 


Miiec 


jui \m 


l??1flC 


iiii ii«i 


2«4(CC 


JIBI 


111! 


23d lEC 


1138 1181 


HllflD 


1BI« IKl 


173^ 1U 


m% 111! 


«23tCD 


1118 


nil 


237 1ED 


ini nil 


142 IS£ 


ii«i Jill 


174 lAE 


]«i» 11 ]« 


3Bd la 


iifli 


nil 


238 1£E 


nil iin 


H318F 


\m nil 


173 MF 


nil !]ij 


717 tCF 


nil 


]iii 


239 lEF 


till nil 


H4t9i 


iiei ««B 


l7d.1BI 


111] »ii 


ZI8 »DI 


nil 


4111 


24B 1FB 


nil 8118 


MS I9l 


leai i«ii 


177 Ifl! 


IBjL flilt 


W9 1DL 


nai 


1811 


241 SFI 


nil iHi 


l^A ISZ 


\m ei]« 


I7B 1B2 


IIIJ ll]l 


711 »? 


1111 II1B 


242 1F2 


nn IIII 


H7 193 


ii»i Beti 


179 IB3 


!«ii eiai 


211 fD3 


nil 




243 1F2 


]in nil 


MB 144 


Jflii iiifl 


m m 


iiii iifli 


712 1D4 


nil 




244 »F4 


nil i]«i 


H9 IPS 


iBIt ei«J 


I8J IK 


jin 111] 


213^5 


nil 




Z4S IFQ 


nn nil 


J»194 


ll«l B1i0 


IB? »B4 


nil iijt 


214 1EU 


nil 




24A tf& 


nn Bin 


!E1 197 


■ 111 nil 


leS 1B7 


1111 Bin 


?lb 1D7 


111] 




347 IF 7 


nil Iin 


152 I9S 


iiei J»i 


!B4 IBB 


iflii i«ei 


21A IDS 


nil 




249 1FB 


nil i»i« 


153 %?9 


IIBI l«B] 


185 IB? 


nil nil 


217 IDP 


nil 




24? If? 


nil laii 


]541flA 


IBIl ll]« 


m i» 


iin 1811 


218 IDA 


1111 




2Sa4FA 


nil ifrii 


155 t?B 


llfll Iflll 


]B7ieQ 


nil nil 


219 IDB 


ini 




m ifi 


nil nil 


l5d1?C 


111] Itll 


IBS 1BC 


nil iiii 


J2I1DC 


ni] 




252 *FC 


nil 1181 


157 >?Er 


mi iji] 


J 89 1B0 


111] 1111 


121 m 


1111 




253: IFD 


111] nil 


158 m 


m\ nil 


]?l <BE 


nil iin 


222 1H 


nil 




254 If L 


nil nn 


15P IPf 


111] nil 


191 tBF 


an 1111 


223 IDF 


ill] 




25^ IFF 


nn nil 





>fcfcLj^D— shan't C;*-n±riclg«» 

Th« VIC-2* hft5 fl fffalyre whith iUowfi k prograni in BOH 
*t4rt^>gi it tASea M#56ai to fiiEze control □+ Hit machino alpowftr-up 
and RESET tiines without sny furthnr intervtnUon rtquired on the part 
of the opcf&tDr. 

A* power-jp limE one erf the very tirst thingc the opsnting 
«yEi«[n div« is chedJ ferd^ivfi character ^eqiieive starting at 
locatiDTt 1AS44. If it firHl3>41»«30ilC3.lC2FtCD it will AutocnaficaUy 
jump to the address It found it »A*eS(1Aefll. A second iddress is 
siorpa in iA8e24Aa03. Thicls the lOdres^ q4 tli» [RESTOHEJ Ksy 
processing rajtine. 

In order to create i cartndfje with Read Only MeiFioryF it wiU 
be oEce^sary to havB a prom programmer. Thas la a device which 
"burns" PROMe. PROMs are prognmmible reid only mpirtorys. A PROM 
be pragrimmed or burned by adDlying the proper voltiges and J-ollGwing 

the presfnbed timirg rules oMhE device t>e:ng programmed. T^e^ 

funrrtions are carefully CDotrolted with a PPOH progrannner. Vinous 
sources exist 4or thess devices arhd it is nothcrribly diHiCult to 
build ycur ovn if yOLihave sairiB electronic skills. Several sucii 
projects have been described m the popLilar comouting ipagi?ines. The 
PRO- contains the necessary infcrmatian on ihe BlecYrical dpfini^ion of 
the expansion port where the cartridges attach tq the VIC, 

Sopie Dt the currently flvailible cirtridges actually corrtam 
BASEC programs. To do thist they do the BASIC setup rrxrtine* in 
mactiine language 'dlowed by putting "RUH" followed by tl3 (carnage 
return) in the BASIC Keybcwrd ttut-Fer at 631-648 and jumping to the 
print R-EADY rciutine. Ttie fErllowing cMdmple »ine out of Buch a 
cartridge: 



may 



PLA 
TAY 
PLA 
TAX 
PLA 
RTI 
JSR 
JSR 
JSR 
CLI 



fteSTOPE KET PROCESSING 



44989 

65817 



r^INLlNE PROCESSING 



JSF5 58-459 




Innd* Tht VIC 










JSR 


5^276 






J£R 


563?? 






LDX 


ttzsi 






TXE 








LDA 


ttna 


SET UP START OF 




STfl 


43 


BASIC TO BE 




LDfl 


tiua 


41873 




STA 


44 






LOA 


«ie* 






STA 


ses 


DISABLE STOP KEY 




LDA 


4eeee 


CHECK FOR lEEE4e 




LOV 


H9 






CMP 


ftU£ 






BEQ 


3*2 






LDV 


ti^ 






STY 


\9S 


It CHARS IN BUFF 




LDX 


H? 




LOOP 


LDA TABLE ,X 




STA 


A30,Y 






DEX 








DEY 








BNE 


LOOP 






JHP 


50292 


PRINT READY 


TtSBLE EGU 


41656 






BVT 


»53D933^5333ft51 DSeO- 



PtgiC-2 



T?ie information in the Uble is SVS4E4:RUNi:Rl in abbreviated 
CDinmarid tormal. The BASIC program slarts a1 41673. Variable atonge 
will Btill beinlDVHT-tnsiriDrvRAH- since tho5t pointtrs van ™v#r 
disrupted from the \in\v ot vector initialiiation. 



IrvidflThtVlC 



PagaD-l 



VIC 20 M«mory M&p 



HcK D^afnil 



Function 



eee? 
eees 

0069 

eeeA 
eaeB 
ed«c 

eeiB 

BBIJ 
0012 

6014 

aeiii 
eei7 

8019 
BQ:24 

Be2D 

ea2F 
aa3S 

6937 

ea39 

SBaB 

eesD 
aesF 
ee4L 

0843 



fl-2 
3-4 
5-6 

7 

a 

9 
IB 

n 

12 

13 

14 

15 

16 

17 

18 

19 

28-21 

22 

23-?4 

2S-33 

34-35 

36-37 

38-42 

43^-44 

45-46 

47-49 

49-58 

51-5? 

53-54 

55-54 

57-53 

5?-6e 

6?-6& 



U5R f nTKtian jump 

FlDit-Jintepef 

lTileger->tlMt 

Search chir '■" orerOlint 

Scar btwn quotas tUg - 69 as delimeter 

Column po5 of cursor on line 

Verify -flaq ^fr-Loai/1- Verify) 

Basic input buffer pointer/ isubtcr-ipts 

DIH flag 

VarjablE flag - typt:FF=string - ifl-numeric 

Integer flag - type:S#^ integer - 6*^floating pmt. 

DATA Hin *lag/LIST Quote *la-g/m*nory flag 

Sut>sp^ipt fJag;FHK flag 

Flags *or input or read IB-inpul - fi4-get - 152=reab 

ATM sign llagiCDmciarison evaluation fkag 

Current I/O device for prompt sL4iprB» 

Basic integer adr.(*or BVS - GOTO *tc> 

Tf mpxary string ieBcriptor stacK pointer 

Last temporary string vector 

Etack of descriptors for temporary ^tfings 

Pnifrter for number trantfop 

Misc number pointer 

Prodct area (or tnult 

Pointer to ttart of Basic 

Pointer to end of prog,5tar-t of variables 

Painter to end o* var^ihles starl o+ arrays 

Pointer to end of arrays 

Pointer to start of active strng spcetconing dwnJ 

Pointer to top of activE strings 

Pointer to end of mimory 

CLirrent Baste line number 

Prev BASIC lir^ num 

Previous BASIC statement (for COST! 

Line number - current DATA hna 

Pointer la amr\\ DATA jlein 

Input vector 



Inttd* Thi VJC 


HCK 


UeQmU 


0645 


i9-7a 


aa47 


71-72 


eai9 


73-74 


ea4B 


75 '7i 


6840 


77 


9»4E 


7S-7? 


e95e 


80-8] 


ee52 


62 


ee53 


83 


Be54 


34-66 


8B57 


67-96 


9^6^ 


?7-je2 


66 47 


163 


Be^S 


104 


ae^9 


185-llfl 


es-^F 


H! 


ee7fl 


112 


8871 


iia-iH 


ae73 


115-138 


fleSB 


139-143 


e95e 


14^ 


6091 


145 


0692 


M£ 


9ft93 


M? 


8994 


140 


6a?s 


14? 


fle¥6 


156 


8897 


151 


699G 


152 


8899 


153 


ee9A 


154 


«09B 


155 


efl9C 


15i 


eePD 


157 


flB^E 


158 


ea^F 


159 


961^8 


ue-iA2 


set^a 


163 



Pig»D-2 



Function 



CijrrBut vdriabJe name 
Current variabie addrm 

VariiblB pointer tar FORy^ErT 

"V sivcyn^wop savB/currop pointer 

Special masK ^or turn cwtriCompirison symbnl 

Hisc. worK arsaj^Einction def pointer hi-la 

Woj* iPffiiooirvtsp to ttrftfl descrptn 

Length d* above string 

Constant u^ed by garbage collect - 3 or 7 

Jump VBCtor" tor tuncTione 

Hisc. nuETierjcal ctordge araa 

FAC*ti 

Scries evaluition c-orfttant pointep 
FAC#1 high ord propngdtion 
Actumulator *i2 

Sigri comparison - FACl V5 FAC2 
Low order rounding byle tor Ac-cKl 
C&asette buffer length /aeries poin-tEr 

Sijbrtn:GetB45icch4ri7A-7B-p[)inter(CHAflGOT) 

RND storage and work area 

Gta-tuE ST 

Stop Hey flag: Ke? 5 witch pia. 

Timing cgnstant for tape 

Load or veri+y *lag L=6;V'I 

Serial output /deferred char- flag 

Serial d-ef erred characler 

Tap* EOT rectfd 

Register save area 

1 open file^ 

[nput flpvicptt - ncrmaliy 6 

Output CMD device - normally 3 

Tape character parity 

Cassette dipoli switch 

OS inessage flag - dirpi=t=ISe - njr=e 

■Cflssdle error paas 1 

Caasettfl error cass 2 

Jif ty clock (HKIJ 

Serial bit count 



ImideTtitVIC 


H*v 


Dicimal 


eBA4 


I&4 


edAS 


\65 


0&i^6 


166 


aeA7 


167 


&9AQ 


l&S 


96^9 


169 


99 f^ 


176 


ae^B 


171 


eaAc 


172-173 


esAE 


174-175 


flsea 


176-177 


eaB2 


178-179 


0054 


laa 


69G^ 


lei 


e»B6 


18Z 


aeB7 


f33 


aoBe 


ia4 


ea99 


les 


a^BA 


186 


eaBB 


1&7 


ddBD 


189 


6aBE 


198 


eesF 


191 


a»C6 


192 


66 Cl 


IP3-1?4 


sees 


195-I9d 


30 C5 


197 


96 Cd 


19S 


esC7 


19? 


eacs 


266 


66 C9 


2« 1-282 


eacB 


283 


sacc 


264 


eeco 


285 


eacE 


ze.^ 


66 CF 


28 7 


66 DS 


2ee 


eeoi 


S69-2ie 



PagaD-3 



Function 



Cycle CDunlerfor eer-i^ 1/0 

Cnidwn <or tape write 

Cassette buffer pointer 

RS-232 input l>it storage /Tape shrtcnt 

RS-232 bit cnt in/ Tape read ertar 

RS-232 flag start bit cH/Tape fd bit err 

RS-2a2 bytP buffer /Tape rd made 

RS'23Z panitv stDrigc/Tape ctikauFn 

Tape start addr/tape buffer / acrGllmg 

Tape erd addr/end of current Dro^rim 

Taps tiniir>g constmTs 

Addr of tape buffer 

R5-232 trinsmitter bit cnt out 

RS-Z3Z transmilter n^t bit to be ztni 

RS-2a2 transmitter byte buffer 

Length o\ current file nama string 

CtJTent logical file number 

CuPT secondary addr - or R/Wcommintf 

Cupr device numbe^ 

Ad<]r Dt Ctrl' file name stnrg 

RS-232 write ihift word/Receive input char 

Itblccks rBmairting to read/write 

Serial word buffer 

Cass motor interlock 

Tape Stan addrlload) 

KERNAL setup pDirtter 
Hatrw co-ordinate 5 of Key pressed 
flof chara tiers in kWyhrd buffpr 
Reverse made flag - 8=off - 18-on 

End of hne for input pointer 

Cursor iogCrow - column) 

Whsdi key - 64 if no key 

Cursor hlinU enjbled flag - 6=&rt - 1-nff 

Delay before cusor blinhs 

Diaracter under cursor 

CuPSDT tm/Dff blin^t flag 

InptJt from suren/Heytirfl 

Screen iddrtf'Dw>pointerlscreen memory! 



Imidt TTw VIC 


Htk 


Decimai 


aecs 


li\ 


aeD4 


212 


6005 


213 


%2DA 


214 


88 D7 


215 


eeos 


216 


9eD? 


217-2=1] 


eBF2 


242 


esFS 


243-2^1 -a 


eeF5 


2t^-2A6 


eeF7 


247-248 


80F? 


249-256 


eePB 


25l-?54 


flflFF 


255 


eiBe 


^^6-266 


eiae 


ZS6-31S 


eias 


25i-5n 


82»e 


5!2-iee 


025? 


ifll-Aie 


8263 


611-628 


02£D 


^21-A39 


3277 


631-64^ 


e2B:l 


1*41-6-12 


6233 


643-644 


0235 


645 


B2ei 


646 


e2B7 


Hi47 


42SS 


64G 


829* 


i44? 


esQA 


^5B 


e2ss 


^51 


Bsec 


d52 


€2SD 


(£53 


ezsE 


i54 


B28F 


i55-i5i 


e29£ 


*57 


e2?2 


£58 


B2?3 


659 



P»fftD-4 



InudvTIwVIC 



Pig*D-3 



Function 



Pflmition a* cursor en curr imp 

Quo-ts made flag Maoft / I^on) 

Lino length for screen (22/44/6^/86) 

CuTpint screen hnt number 

ASCII viiue of Ust key prses 

* of inserts ou-t^tsnding 

Scrctn Jine hnK ^ible 

ScneBn row mirker 

Sera en toior ptr 

Keyscari XiMe irdirect 

Pointer 1o RS-232 rectiva bijffer Addr 

Painter to RS-232 trancmittBr buffpr ddflr 

Free zero cage Incations 

BASIC ^tpriga 

FlMiing to ASCII 'MtV area 

Tflue errcir log 

Processcr slack arej 

Basic input buffer 

Locfjtilfile num&er tablB 

Device numOer tafiie 

Secondary addr of R/Wcmd - table 

Keyboard buffer 

Start D^ memory 

Top fl* nemory 

Ssnai fiineDirt flag 

Active calor codt 

Original color under cursDr 

Screen page 

Kei^boirS buffer mai( length 

Repsil flag - ^"cursor nnly - i3S=alllleyB 

Delay before repeat occurs 

Delay btwn repeats 

Shift flag byle 

Last shift pittem 

If>dir*[:t -for keyboard table setup 

S^iift mofle switch - d^inabled - 128-loclttd 

Ajfo scroll Own flagCfl-on- OS^off) 

HS232 COPiti-nl registar 




H#K 


Diciinil 


Function 


0774 


66« 


PS232 Command register 


0295 


66i-642 


Non star!riard(biHiine/2-ie«} 


82?? 


663 


HS-232 status register 


e2?s 


664 


Huirrbir of bit^ to send 


0299 


665-666 


Baud rata -full bit time 


B29B 


667 


RS-232 end of receiver pointer 


02 9C 


66^ 


RS-23Z start receive buffer 


S29D 


669 


RE-23? atari trirw nil enAttuib\A 


B27E 


670 


RS-2a2 end of trantmit buffer 


029F 


671-672 


Holds IRQ during tape operation 


62^1 


673-7^7 


Ppogram indiptcts 


0380 


76e-769 


Indireci error routine 


0?e2 


776-771 


Indirect wa-rm start 


6304 


772-773 


Indipsd crunch BASIC 


03flA 


774-775 


Indirect token print 


8306 


776-?77 


Indirect rv^ toMen 


«3«i^ 


776-77* 


Inb^ect symbol tvaluation 


030C 


7 SB 


Ttmpor-ary storage di^ng SYS of A-rtg 


e36D 


7SJ 


Temporary stor-age during SYS of X-rsg 


03eE 


782 


Temporary storagr flurir^ SYS of Y-rcch 


03eF 


7B3 


Teinpopary *tcrage during SYS of P-rpg 


6314 


786-789 


IRQ vector 


0316 


7?e-7¥l 


BRK vector 


8318 


792-793 


NMI vector 


031A 


7?fl-795 


Open logical file vertDr 


B31C 


796-797 


Clo^e logical file vector 


031E 


798-799 


Sat input device vector 


0328 


880-801 


5»t output Oavitt vttior 


a322 


802-803 


Reset de-fault 1/0 


0324 


684-805 


[nput from device 


e32d 


806-867 


Output to drvicv ^tcXor 


032B 


008-039 


Tail STOP key vector 


032A 


Bie-8U 


fjti from keyboard vector 


a32C 


812-813 


CJo«e ill filti vtc1(X 


032E 


H14-Bi5 


Ba^lc U^ command vector 


8330 


816-817 


Load from device vector 


0332 


818-819 


Save to device vectnp 


833C 


82B-iai9 


Caisatte buffer 




iMiili Till VIC 



Pta>D-« 



iMldiThtvic 



p«a*D-7 



Hex Dfcimal 



Function 



leae 
JESe 

4066 
699d 

leae 
i2Be 
940 e 
eeae 

sees 
?00e 

9061 
9062 
9B03 
9084 
906 5 
900^ 
9907 

?eae 

9069 

909 C 
906 [> 

9e9F 
5il& 
931 a 

5113 
9J14 



16384 
2457i 

4*^6 e- 

37863 
327^8 
327*8 
23792 

368A4 

^d3d4 
3iG^5 

3*3ii7 

3£36a 

3*874 

3£3?1 

3riS72 

36B73 

3*874 

3*875 

36S7* 

3AB77 

3687B 

3437? 

371 3i- 

371 Si 

37137 

37136 

37139 

37149 

57] 41 



4095 3K E-j^oansior RAH area 

767? Uspr Basic are* 

8191 ScrF«n irsmory 

1 A3&3 3ke]<pan5ion RAM/ROM black I 

-24&75 6KtKpinsionRAH/H0M WocH2 

-327A7 *Ke>rparsinn HAH/ROM blodO 

4^07 Screen memory fRAH > SK) 

User Basic arp4 {PAH > 3K) 
-38399 Colour RAM LflAH > SK) 
'348^3 4KfharidergBfi&ratqrR0H 
-33791 Upper ca» and graphics 
-33815 Pevffrsed upper casff and graphics 
-36Si3 RovenHd upper and Iflwer cise 
-37B87 I/O BLOCK a 
-3<^879 Address c4 VIC chip registers 

biti fl-riihorLZ Mfitmg/bil 7:interlacE 

vprticil centeririg 

bits *-i:(t caU/bit 7 part of scrn me^ 

bits l'6rM rows/bit e hIb »x8 or li-i8 chars 

TV raster beam tine 
bits -9-3 mtart of character Fnemofy 
Horizontfll position of light pen 
Vertical posttion at Jighl pen 
Digitired- value of paddlfl- X 
Digitized value q4 paddle- Y 
Frequency for oscilUtor 1 llow) 
Prequercy *cr DHillatar 2 lI^EdlLl^n^ 
Frequency for os dilator 3 (high) 
Frequency o* noi^e scurte 
bits e-3 : volume/ 4-7 :4un liar/ tolop 
Screen and Bcrder color register 
37151 6522 VlANo.l 

Port B output registpriuser port fisrs?) 

Port A output register 
Data directicm register S 
D-ita Aire ctior registrr A 
Timer 1 low Ayte 
Tlffier 1 high byte 




Hbk 


decimal 
37142 




Function 


9ni 




Timer 1 low bytv 


9117 


37143 




Tinrer 1 high by-te 


9118 


37144 




Timer 2 low byte 


9119 


3714S 




Timer 2 high by1e 


9nA 


G7i4* 




Shi-Ft register 


911B 


37147 




Au" iliary control regisler 


9liC 


37149 




Peripheral control register 


9110 


3714? 




Interrupt fiag rsgister 


91 IE 


37150 




Interrupt enable register 


91 IF 


37151 




Pert A ^sense cassette switch) 


9126 


37152- 


37167 


652? VIA NOp 2 


9126 


37152 




Port B oirt[hit register 


9151 


37153 




Por-t A EHjtput register hey bpard row scan 


9122 


37154 




D»td direction register B 


9123 


37155 




Data direction register A 


9124 


3715^ 




Timer 1. low byte latcft 


?l?5 


37157 




Timer l,high byte Latch 


9124 


37153 




Timer 1. low byte cixjntpr 


9127 


372S0 




Tirpier 1, high byte counler 


9128 


371*6 




Tuner 2.low byle latch 


9129 


371*1 




Timer 2. high byte latch 


912A 


3714? 




Sii-ft register 


91 2B 


371*3 




Auxiliary control register 


91 2C 


371fi4 




Peripheral control register 


91 2D 


37165 




Interr^Ct flag register 


91 2D 


371*5 




Interrupt enable re-gister 


91 2F 


37167 




Port A output register 


94B0 


37838- 


3339? 


Lucition 0* COLOR RAM (HAM > 610 


9*06 


33406- 


36911 


Normal location of COLOR PAH 


9899 


3S9i2 


3993^ 


1/0 block 2 


9C00 


39-93*- 


40-955 


I/ab1ocK3 


A868 


49 9^6 


49151 


E>:pan9iCin ROM 


caee 


4?'J52 


5754: 


BABIC 


CB0e 


491 5Z 




Keywunj action addresses 


ce4* 


49222 




Function action addresses 


Ce74 


19248 




Operator action addrf sM^ 


Ca92 


49296 




HeywoM Table 


CI 93 


49555 




Error messages 



imfdiThiVic 


Hex 


l>«ciinai 


C3&; 


58 a 58 


C3Be 


seifl^ 


C3FB 


5ej7i 


OBB 


58JGa 


CA35 


59^29 


C474 


5e2?2 


C49a 


56387 


C533 


50433 


C5i9 


53523 


C57C 


50556 


Ci^JS 


587^7 


Ci43 


5875-1 


Cdi£& 


36761 


C6QE 


^eese 


C69Q 


50644 


C743 


5iet0 


i:7FD 


SMS] 


C8JD 


5122¥ 


C92C 


5J244 


CS57 


512S7 


ce7i 


513f3 


ce33 


51331 


CdAe 


SlSi^e 


C8P2 


51418 


C8£B 


51435 


C9flA 


514iS 


C9B9 


5H45 


C925 


5J49-6 


C93B 


51515 


C94a 


51531 


C^iiB 


5i5j^3 


CyA5 


51A31 


CA8e 


51 84-9 


CAB6 


5 J 34^ 


^(i?fi 


^\866 


ceiE 


5i996 


CB3B 


52827 


CB4D 


52045 



^4DBD-e 



Function 



POP - G05UB search slacK 
Open iTremgry ^pdne 
Tfftl stack depth 

GKecI< ivailablo memory 
Send error mes&i^i 
PriPt READY. 
iievr BASIC line proctasing 
BASiC line chairdrig 
Peceive line from keyboard 
ToKsnizf BASIC liT* 
Search *or line number 
Perform KEW 
PeHoroi CLR 

Reset BASIC ei^ecution To start-al-program 

Perform LIST 

PerfDrm FOR 

e>[eculE BASJC BUtement 

Perform RESTORE 

Pertorm STOP ar>d £ HD 

Perform CONT 

Per+orm RUN 

Pen-form GOSUB 

Per-farm GOTO 

Perform RETURN 

Pertorm DATA 

S^an for nejit Etatement 

Snanff^ne^ft line 

Perform IF 

Perft>rm REM 

Ppi-form QK 

G«t integer from lext 

Perform LGT 

Perform PRINTM 

Perform CMD 

Perform PRJ NT 

Print -string from any tntjttary 

Prim formal charflcler 

Procpss tAO input 



tnddffTtwVIC 




Httc 


Declnl 


Fiinclioi^ 


CB7B 


529 PI 


Perforin GE T 


CSAB 


52133 


PftP*ormiKPUT<t 


CBBF 


52159 


Per+orm INPUT 


CBF9 


52217 


Pr^Dinpt L input 


GC04 


57239 


PflHnrrr READ 


CCfC 


524 7 A 


Input error meseagttS 


CDIE 


52516 


PerfcriFi NEXT 


CD7B 


5Z68B 


Ty[jp match checK 


CD^E 


52636 


Evaluate eKpreesion 


CEAS 


52984 


PI in floating point 


CEFt 


52?77 


QvftluatE within pirEnth»i5 


CEF7 


52963 


Chac+t tor T 


C^FA 


5WS<; 


ChecK for "i" 


CEFD 


52989 


Check top" -' 


CF«8 


53eee 


ByntaK error 


i:fj4 


53012 


5ea.rrh -far vanable nane 


CFA7 


53159 


Set up FN references 


CFE6 


53222 


Perforin OR 


CFE9 


53225 


Per for in AMD 


D0]^ 


53278 


Corrpsrisofi routine 


Da7E 


53374 


Perforin DIH 


09 SG 


53337 


LQC&te vArlAblr 


Dn3 


53523 


Ched< for alp^a A3CII 


D11D 


53533 


Crvate new variable 


01 P4 


53i£52 


Amy [lointer routi™ 


Dl^5 


53-169 


3276$ in filiating point 


DiSP 


53i495 


FACl to integer 


Dl[>l 


53713 


Find or Create Array 


D34C 


54692 


Co input e ^ubfic^pt size 


D37D 


54141 


FfirfDTin FRE 


D3P1 


54161 


Integer toFACl 


D39E 


54174 


Perform POS 


D3AA 


541 8Z 


ChEcK+w DIRECT modi 


D3B3 


54195 


PerforiTi DEF 


D3E1 


54241 


Chetk FN syntajt 


D3F4 


5426S 


Eva^ua<t« F N 


0465 


54373 


Perform STR» 


&475 


54369 


C«lnjla.te siring vfrctor 



PagtD-9 
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Kex 


DedmiJ 


D43? 


5^1467 


D4F4 


54516 


D524 


545ii(i 


D5BD 


54717 


D<^9^ 


54798 


C63D 


54S-I5 


Oi7S4 


549ed 


DAA3 


54947 


Ddoe 


55633 


D6EC 


550^6 


D7BB 


55^40 


D72C 


35054 


D737 


559?5 


D76t 


55137 


D77C 


551*1 


D7S2 


551 7B 


D7eB 


55J7? 


0793 


55195 


D7AD 


S52I3 


D7E& 


55275 


D7F7 


5-5237 


DS0[> 


55389 


0824- 


55332 


f>82D 


55341 


[>64V 


553*^ 


Da5e 


55376 


DOi^ 


554B2 


D?47 


55633 


DP7E 


5567B 


O-^ea 


55683 


;>?Bc 


55716 


D9EA 


5578i 


DA2S 


55349 


DA30 


5505^ 


Df:^57 


558? 7 


DA8C 


55949 


DAB7 


55991 


DA04 


56820 



PaV*D-1« 



Funrlion 



Bet up string 

Birild string vector 

CoHect garbage Lrnain room for string} 

ChecH string collection eligibiLtj 

Collect 5trjr>g 

CLjncdtpfwte striBTg 

Binld string to momory 

Discard urwmtBd string 

Clean the destriplor stdiH 

Perform CHRl 

Perform LEFT* 

Perform RIGHT* 

Perform MID* 

Pull EtPtng parameters fram staclt 

Per4om LEN 

W!<it string mode 

Perform ASC 

Input bytp parameter 

PerfcM'm VAL 

Q*t POIffi/WAlT parimetBrfi 

FACl tointiger 

Perform PEEK 

Perforii) POKE 

Perform WAIT 

Adde.S toFACJ 

Perform siJitrflction 

Perforfn a-ddition 

CompleniEnt FACl 

OvepfiQw 

Sirgle byte multiply 

Floating pioint conetanls 
Pffrfnrm LOG 

Muhtpiy FACl t nenory 
Multiply FAC? *FACl 
Multiply a bit 
Memory to Facz 

Adijfit FACWFAC2 
Underflow/ q wrf low 



InUdflHtVIC 




Hex 


Deciit*! 


Function 


DftE2 


5^634 


KuLtiply FACl by 1* 


MF9 


56«57 


Constan* 1* 


MFE 


5^662 


Divide by 1 


D&S7 


!14e7l 


Divid* FACZ / mviAOry 


DeflF 


5Afl79 


Divide memory / FAGl 


DB12 


54'B82 


Divide FAC:2/ FACi 


DBA2 


56226 


Hflnory to FACi 


DBD7 


56247 


FACl to memory 


DBFC 


5<431i 


FAC2 ia FACl 


DCflF 


56335 


FACl to FAC2 


DCJB 


56347 


Rcxnl off FACl 


DC23 


56^62 


Qit sign 


0C39 


56377 


PaHcrir SON 


DC5B 


56403 


Perform ABS 


DCSB 


5*411 


CompiPe FACl la memEipy 


DC^B 


56473 


FACl to integer 


DCCC 


56524 


Ptrform INT 


DCF3 


56563 


ASaitoFACi 


DD7E 


56782 


Qet new ASCII digil 


DD33 


56755 


Constafitt 


;)DDD 


56797 


FACl to ASCII 


OFll 


57183 


Hare constaMs 


bt=?i 


572fll 


Perform SOH 


DF7a 


57288= 


PtH C'l'ii* Av ponentiAtion 


DF34 


57268 


Perform negation 


DFBF 


57279 


More fcrictantft yii 


OFED 


573^5 


Perforn EXP 


EBia 


57489 


Series evalmtioo 


BAQf\ 


57492 


RHD mnst4nts 


£894 


57492 


PeHorn RHD 


E261 


57953 


Perform COS 


E268 


57948 


Perform SIM 


€2B1 


58033 


Perform TAN 


E2DD 


58077 


Constants for trig -functionK 


E3eB 


59123 


Ptrform ATH 


E33B 


5B17] 


Constants for ATM 


E3?3 


S&232 


Initialize HAM vectors 


E3S7 


58247 


QiROGT for ziro pigr 



p«ltl>-ll 



InsidtThi VIC 



Hot Drdmil 



PtQ«D-13 



Function 



E3A4 


se?7^ 


Initialin 5aSIC 


E4EP 


5346 f 


HnsAgfi 


E44F 


58447 


Vector tfidtlalizatioiT 


EAA7 


5B497 


Warm ^eH^a^t 


E476 


5856 2 


Pragrai!^ piTch trtt 


E4Aa 


58528 


S»ri*l output "l" 


E4A9 


5S537 


B<riAl output '%" 


E4&2 


5854* 


(ivt Hriil input ft clDcK 


E4BC 


58556 


Pmgram patch araa 


E5»a 


58624 


S«4£522Addr5 


E5a5 


5B*29 


Set urtBn limits 


ESBf^ 


58634 


Tf-acK. rzixsor location 


ESI 3 


38646 


lnitia]i2B I/O 


t54C 


58708 


HDrnali?* 9cntn 


E55F 


587J; 


Cl«»r screen 


£581 


58753 


Hdidb nraor 


E5B7 


58759 


Set fiCTtfen pointtpi 


E5BB 


58811 


Set I/O defaults 


E5C3 


58319 


?«1 vkthipdflfiultt 


E5CF 


58Q3I 


Inpjt from Upyboard 


E£4F 


58959 


Input frorti icrttn 


EdSeS 


59864 


Quote marKtest 


E*C5 


59877 


SpI up 5crf»n print 


E6EA 


59114 


A-dvinc0 cuTftor' 


E7i5 


59157 


R«tre it cursor 


E72D 


59181 


BdcK into prtvious line 


E742 


5928 2 


Output to su«en 


EeC3 


595a7 


Go to next line 


ESDa 


59686 


Do 'RETURN' 


ECEQ 


5?624 


Chnck lint d>a«m«nt 


ESFA 


59674 


ChecK line inovnent 


£9\2 


5^666 


Set tulour code 


E921 


5969i 


CdIout CDdt ttble 


E92? 


59689 


Code conversion 


E975 


59765 


Scroll screen 


E9EE 


5$'886 


Op«n apace on scr«tn 


EA^6 


59P9B 


Kovt scrun line 


EAdE 


60814 


Synch raloi^ tranater 







iMMtThVIC 




Hnt 


DtdMi 

A0e^ 


FuTKtian 


EA7E 


Efft stiJ*t-^J*-liw 


EABD 


68845 


Cleir scrcEn line 


E^l 


6B865 


Print to Bcreeri 


EAM 


A«074 


Btop* on «T«n 


EAB2 


60032 


Synch colour to ch^ 


Ef^8F 


6»e95 


Intem^it aRG) 


EBIE 


6fll?e 


ChccK ^yE^DArd 


Ecae 


6B416 


Eat text mode 


EC46 


6»4e& 


|f«Vboa.rd vectorE 


EC5E 


60518 


KvYbDftrd mapt- 


ED21 


68705 


Qraphica/tent control 


EDse 


da7?a 


5ei graphics m<}di 


ED5B 


6&763 


Wrap up screen line 


E06A 


68778 


Shifted Hey (n«.triK 


EDAS 


£9835 


rwrtral tev mjtrin 


EDE4 


60980 


Vic iMp fletibltfl 


E[>FO 


68925 


Server line adds low 


EE14 


68948 


Sind 'talk' 


EE17 


60?5L 


Send 'listen' 


EEIC 


69956 


Send tontrol diir 


EE47 


6k00L 


Si-nd to vrialbu3 


EEB7 


61111 


TiAeout or sertil 


EECe 


61128 


Send listen SA 


EEC5 


dll25 


Clftr ATH 


EECE 


61134 


Send talk SA 


E€E4 


^115^ 


Se-nd uri*l da-4trrcd 


EEF6 


AIWA 


Se^nd 'untallC 


EFB4 


61108 


Send 'uUisten' 


Efl9 


6120? 


Reciive from «rial but 


EFB4 


61316 


aDCkUneon 


EF8D 


61325 


ClocK line of^ 


EF96 


61334 


Ddlay 1 m? 


EFA3 


61347 


RS7a2 sifid (HHU 


EFEE 


61422 


New RS237 byte send 


reiA 


61462 


Srror or quit 


FB27 


61479 


Cofltpcrte bit count 


Fa36 


61494 


R673? receive iHHl) 


Ffl5a 


61531 


Setup to rscffivi 



PegiD-H 




InudillHVIC 


Htx 


Decin^Al 








Fe^D 


A15S7 


FaA2 


£1602 


F8A5 


6i6S5 


FeA8 


616ZS 


FaB? 


61625 


F&8C 


6\62G 


FBEt 


61677 


Fili 


at7lB 


Fl^F 


ii775 


Fi6a 


617?2 


F17fl 


iiSiJ 


F1E2 


61922 


FIF5 


&{9Ai 


F2e5 


A1957 


F2a£ 


il9i,i 


F25e 


62B32 


F27A 


42674 


Fe?8 


62896 


F2€7 


<*2J51 


F3BP 


^22; 7 


fS^i^ 


62^32 


F3CF 


62415 


F3DF 


^243t 


F3EF 


624*17 


F3F3 


62451 


F4eA 


A2174 


F4?5 


62613 


F'lC? 


626 6 3 


FS-^? 


62?Gi 


F647 


63^47 


FA59 


636 65 


FA6A 


63982 


F675 


638 93 


F729 


63272 


F734 


63264 


F760 


63328 


F7i7 


633 35 


F77B 


63344 



Ptgt I>*H 



Furrction 

Rtcei^B parity error 
RertivE averrin ennor 
ReceivE breik error 
Re«iu* frairiB errof 
Ba-d device 
FiU to RE237 

S*ndtDRS232 birtfej* 

Input -from RS2a? bu*+Er 
Gei trom R-S732 buHer 

ChecH serul bjs id^ 

Me«sageg 

Prirrt if dir*ct 

..+rDni RS232 

input 

Get. .tape / seri al/ RS? 3 2 

Output.. 

..t[> tipe 

Set input device 
Set output devin 

Find file 
Set file values 
Abgrl ail hies 
RES-torp d&fault J /a 
Do file EDpening 

Oper P5232 
1-Aad program 
SEAR CHI KG' 
Pnrrt file name 

'LOADIWG/VERFFVTNG' 
Save program 

^SAVING' 
Bump dock 
Gel -time- 
Set time 
Action stop tev 



IraUiThtVlC 


Pa 


}\wy 


[Jectmil 


Finctiqn 




—■—■——" — 


F77E 


63358 


File Error MessagPB 


F7AF 


63487 


Find BEiy tape header 


F7E7 


63443 


WrilE tape header 


V&AD 


63565 


Get DuHer Address 


FG54 


63572 


Set birfter start - end poimtera 


FeA7 


63S?1 


Find specific header 


F8SA 


6S626 


Sump tape poin'ter 


F8?4 


63i^36 


■PRESS PLAY' 


F3AB 


63659 


ChecK cassette status 


F8B7 


63671 


'PRESS PECORE' 


F9ce 


636Se 


Tmtiate tape read 


FSE3 


63715 


Initiate tape wjrite 


F8F4 


63732 


CPFitnon Upe read /write 


F94B 


63919 


Check tape 5top 


F95D 


63937 


Set timing 


F?eE 


63966 


Dead bits (IRQ> 


F^^O 


64173 


Store characters 


FSD2 


64466 


Re 551 pointer 


Fism 


64475 


New tape character setup 


FBEA 


6449e 


Toggl? tape 


Fce6 


645] 3 


D&ta u/ntE 


FC9B 


64523 


Tape write (JRQ) 


FC95 


64661 


Leader write 41 RQ) 


FCCF 


6'171? 


Restore vetlors 


FCF6 


6475a 


Set vector 


F&ea 


6^776 


Kill piDtor 


Ft) II 


64735 


Chech r*ad/wriie pointBr 


FD-1B 


64795 


Sump read /write painter 


Ft22 


64^62 


Powerup entry 


F&3F 


64831 


ChecH A-ro m 


F&52 


64859 


Set Hemal? 


F&ao 


6499* 


Initiali« 5V5lem const iPts 


FOFl 


65869 


IRQ vectors 


FDF? 


65617 


InHiali^e 1 /D regs 


FE49 


650V7 


Sa¥» dA\A name 


FE59 


65164 


Save file details 


FE57 


65111 


Get status 


FE66 


65126 


FUg ST 



PifftD-U 




Irwidr Thi VIC 




Hek 


Decimal 


Fuix-lion 





-^ — 


_ — _— __ -.. . — -____ 


FE6F 


^5135 


5ot timeou-r 


FE73 


^513? 


Read/sel lop "le-mopy 


FES2 


ii5154 


Reafl/se't balfom cf Er^irary 


FE?I 


65169 


Teit memory lacjtior 


F£fl* 


^5i-93 


KWl interrupt enlry 


FED2 


65234 


RESST/STOP warm start 


FEDE 


^5246 


NHl RS?3?5frTirnce5 


FFSi 


^53^£ 


Pestare fi eMt 


FFbC 


65372 


RS23? timing Uble 


■FF72 


i53?4 


Hiin IRQ entry 


FFS** 


^54 38 


Jumbo jump tAblE 


fFFA 


6552a 


Hardware vectors 



pao»d-ia 
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Smmpla Slt'HAppvd plD-t-ting 

Thr fcrl^cwirrg prograffiQ ft/4 in euainple G^ a m^chirw Idrtguage 
UdbrvutirtEi nalUbJe by either BASIC or machine Unguage^ arKl a BABIC 
fiTDgram which incorporates and uses the rou-tine- TKe machine lar^giiage 
pragram i^ designed to "(urr^ on individual pLiTcls tiased on a ]< and y 
b-lt-position passed ^roin the callirig rciutine. The routuTS as^umES 
■l^at the character pattern table has been set up to 5tart at location 
512«- ThUiSMtasanEQU UOeled CH. Changing Ihe EQU is alMhst 
IS necessary to change the routine to use inother arpa. It also 
aSQuEFics that the k and y bit positions have been stored as rumbers in 
IhB range cf S'l27 in locstiarra i and 2* The icper left corner of the 
screen i«- considered pit position fljfl and the lower right is position 
127pl27. Location zero ts used as a mode switch. H the ^alue 
EDHtairwd there i^ ^reiter than i27f the E^iJ^cJ at the specified 
coordinates will be set on. I* it is less than 123 the mode is erase 
and the dot k/lII be turned of-f. 

TTie BASIC program ^.^ich calls the plot rou-tine has'the 
res(>Dnsibility o^ setting up the screen parameters- The character 
memory U Ml up to bsgin at 312S and tde screen mc-ofDrv i! Ht ud to 
begin at 485fi. T^e screen si?e is set at i6 lines by 16 cglurrms. All 
o* these Kmttiors are accomplished with the foLir POKEs in line IflS. 

The forffground color la wt at bUck *ar al] scren poBitiors by 
stateflient llfl. The screen codes ire pre-initialiled to a-255. the tap 
!*fl corner of the screen having value 6 and the bottom nght having 
255. ThiB is done in statement 136, Slate me nt 14ft and iSfr are the 
mainlkne of the program anc^ Simply cause a hne to be drawn from the 
upper left corrwr to the lower right and he erase-d repetitively. 



The BASIC program: 

les POKE 36.&i'Jt^^y.?0M^6^i*;\i FOKE 3£8£Sr3d: ?QKS 36^i6;i6 

POKE 36347.32 

lie fOfil? 37868 TO 3788G + 5851 POKE 1,8!; NEXT 

i2e FOR I = 5i2B TO 7ifi7; POKE I,*: NEJCT 

138 FOR T ' 4*9^ TO *^96 * 255- POKE 1. 1 - 4*9A: NEXT 

14«POKe»,l2e:G05US 158: POKE #,#- SOSUB I5flt GOTO 146 

158 F0P1 = 9T0 121 POKB IJ: POKE 2,1; SYS 90*8; NEXT: 

RETURN 



Imidt Thi VtC 



Th0 machine languigfi pragrgm: 



Fi«iB-Z 



I 


MODE EOU 


» 






3 


IJX 


EQJ 


] 






3 


^ 


EGU 


Z 






A 


LO 


EDU 


5 






5 


HI 


EQU 


4 






6 


CM 


EQU 


512a 






7 




Eau 


7986 






B 




LIW 


He 






5 




STA 


<-HI 






18 




LOA 


MJY 






11 




t^D 


1I*F3 




S « lNT(V/8> 


1? 




L&X 


tt3 


-4 




13 


LP 


A£L A 


* 




14 




ROL 


^-HI 


S! 


ROU-DISP = liJtf S^INT^'r 


15 




DEX 




-t 




!A 




BPL 


LP 


* 




17 




3TA 


*L0 






18 




LDA 


*^X 






19 




i^D tF8 




COL-DTSP - 9 • INT <Xy3) 


28 




f^DC 


*-J-0 


* 




2i 




ST A 


*-L0 


# 


ROU + COL 


22 




BCC 


H 


It 




23 




INC 


*-Hl 


K 




24 


H 


LtiA 


tLJY 






25 




CLC 








26 




ANS 


♦t7 


H 


CHAR PAriEFfil RHi^ 


27 




ADC 


tLO 






28 




BCC 


H2 






2? 




INC 


*-HI 






3e 


H2 


CLC 








31 




ADC 


NCH 


S 




32 




STA 


--LO 


It 




33 




LM 


eni 


* 


ADDRESS = CH+DISPLACE 


34 




ADC 


flCM/asi * 




35 




STf> 


*-HI 


t 




3i^ 




IDA 


*vx 






37 




AND 


117 




BIT POSITION 


SG 




TAX 









IfKidtTlltVIC 








39 




LDY 


«fl 




48 




TYft 






41 




SEC 




ii 


42 


ROff 


QOR A 


* 


43 




DEX 




t 


44 




BPL 


RDR 


* 


45 




BIT 


*MODE 




4d 




BMl 


QRA 




47 




EOR 


*I»FF 


• 


4S 




^D 


<L0),^ 


» 


49 




STA 


<LO),Y 


■ 


?0 


ORA 


ORA 


aO) ,'i 




51 




STft 


(LO),T 




92 




RTS 




# 


E 


xpUnaliiX 


- 







?4gal-B 



POSITION THE BIT 



SET OR RESET 



RESET 



RETURN TO BASIC 



Thf 9cre«n has L£ rows of i£ chancters each. Eadi chancttr 
has Bigh-f rows of «-ight dots aach. The screen memory conlaina a 
Mquentlal se-t of chanctBr codesr -fram 4 io 255. TTse firsi sivtHn 
ai t^e scnerL cobis iride>E the chu'acter Futterns wtiich ^ill spp«dr an 
the top Lirw, the sacDnd Bi^itfiGn ret«rBncing th? pattsmE whic^ wili 
ippear or thj Mcond line* stc, Sot chararter palTem *t« ii Iht 
pattern -for the upper left eiEfht by i-ight block of dcts and character 
p4tt»m ttl ka the blocV to the rigtit of that and character pat-tern #16 
IE tfip pattern erf dots for the block below it ind M forth till 
character pattern tt2S5 which bescribes v^ich pixels will ti# 
ilJuninat«d in the bottom right comer of the streen. 

The aboYf muhirw Unguage submjtme comt'ute^ which pattsm 
corresponds to any given X and Y dot foordinatr. It ilea computes 
which hyie within the eisht-b^te pat-tern holds tfi* dot in quettion and 
which bit position within tha-t by-ts to tuT^ on or off. 

The Y value r«pr»5&nt(> how- tar froni the top of the an^en the 
[kit iH located. II it is irt the range d-F 8-7, the dot is in tht *irs1 
row of characters. If is is S-15, it is in -the second row, etc. Bo to 
find the row Y must be dbvid«d by S. 

Each PDw of diiracter^ Eiaitain^ 16 patterns urm^the ^crcBn and each 
pattern contains eight bytes cf data. Sg^ for every row, the position 
vithin ttie table increases by 8 times 16 or i2&. 




Irnld*Th« VIC 



Pftgil-4 



The Bddresa of thi afiprapnatp bytt of thfr table to nodifj^ is 
built in »he twQ-byte field labeled LO ind HI. Stalppients i*-i7 
fonpufe th« displacement into the tibia eElw to ttvp Y value. Statimmt 
11 BtripH th* iDW-flPdiP tfir** bils frcn the Y-v*li«. This 
accDtnplishiE Qoth th« mititl dMelon by 6 to find the rovfiuiMfr and 
thii multiplicaiion by eight. H wfi now multiply tfils "stripped" vaiut 
of Y by Idi wa will get the "row-^ieplacimBrrt" into th» cha^'ictBf 
table. ThiEis eiiactly what 3-tatements 12-1^ da. ThlfiiG a fcxjr-bit 
le+t shift. Evpry time a number IS shifted left orw bit th» number 
if>tr»H5 in vtlut by a ficlcvof two. Sdi a four-bit shift is a. 
multiply -Qy-1 4 operation. Note that the carry bit is the 
communication between the two bytes af Ihe shift operation. Th« bits 
which tqrie off the lifl of ths A-reg get ahift«d irto tht bytt at HI. 

The X! value tells js how far into the row we -must go to ^t the 
proppi^ tharacter within the row. An X value nf fl-7 would address the 
first charactBr within the row. A valuf pf g-i; ^vould iddrtn Ihi 
Mcond, etc. Dividing the X-value by 8 flives ttie character position 
wLlhin the row. Eich chiratter has eight bytat af infwAation 
associated with it In the pattern table, so w« have to mLdtlply the 
character positiim by eight to get th« displacement into tho raw, 
St-itBmint 19 effectively accomphchps both fincticns at the &ami time. 
It strips the low-order three biti, which is liU shifting right three 
bits Idivisian fay eight) then shifting tsacK left again (multiplying by 

Bight). ThischardctBrpMition within the row 15 adflBd to thi "pdup- 
displacement" previously camputed based on the Y-value- TTie result 
goes bad< into HI-LO. 

Nr»ti the b^'tt within the character pattam cnu^t be computed 
and added into the displacement valuH deing bmlt. Eadi byte within 
ths character pattern description describes a different row o* bits or 
pixels on the screen. The Y y^lue mntaira the row inforniitionr In 
fact» the low^xiler three bits may be seen to be the "character row" 
value. They may have the value af fl-7. To strip off the high-order 
bitsr the instruction at statement 26 is employed. This value is then 
added to the displa»iFient. 

Nowi in statementE 3«-35, Ih* addpeai of ttit Hart of the 
character pattern table is added to the displacement within the table 
to get the address of the ectual byte to modify. 

The only thirtg remaining is to get the actual bit within the 
byte and either turn It on or off as indicated by the mode switch in 
location 6. The low-order three bits of the X-value may be considered 
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the bit-positiw. State merts Si-HB strip off the high-order bits and 
transfer the value into the X-reg where it will be used as a ccujnter. 
Statements *1'44 shift the carry bit into the A-reg. The carry bit 
will end up the same number of bit positions from the left as tha 
vaLue created in the X-reg. This byte tan now be used to modify the 
byte we have jjst computed the position of. Ttie BIT irBtnjction tests 

the hiQh-wder bit of locatior e to see if a setor a i^aet of the 
specified Bit isrequired. It it is aresetr the bits in the A-reg 
are flipped so "the AKC ins-truc+ion can set the proper bit off. Recall 
that AND needs zeros in the bit ppsitj-ons which need to be tur™d off 
and ones in th* bit positions which need to remain unchanged- 

If a "set'" is rpouestedp the OPA instruction will accomplish 
the deed, finilly. we retirn from whence we irfore called by the RTS. 
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BASIC Progpams may ba rsadily Ids aecl into any pip ce of RAM 
large ersdugh +□ accomodate thprn. In -^act, many different BASIC 
programs may be in nemor;^ at iht EiDfl ti:ne but in flit-fsrftrt places, 
Thf pragram which La "current" in Ihii ayfitem at anv one tirne 15 the 
cnp ^hith a pointPd \o bv 1h& "sUrt-Dt-flASlC" pointer at A^M. 
Loading a program into an alternate location is simply a matter of 
changing 43,^4 to point to the afldresa where you wish the program to 
Load. 

To get the program to RUM in the aittrnate space requirps an 
additional Dperation. The byte immediately preceeding the program 
Joad I0dr*55 ipust have the vaJjs "lar. Without doing -Ihis, RUNning 
the program v/ill prnduce a SYNTAX? ERROR- 

&3f the procedure 15: 

POKE 44,>r«/?56: POKE i5,>^x>\-P-EEK{iAH2Z6: POKE >[^].-l,e:CLR 

where xxx la the address you wi^h to Itjid the prcjgram into. 

Wh*n SAVEtng a program, the *nti ft fliHrnorv apace between the 
addressea at 43,44 and fl5»4ri will be SAVEd- It la thus posBibla to 
SAVE multiple programs as one large memory loa.d. 






UPQR AOE OP" P" aR 

■mere are three upgrades posEible to the standard vercicr of DBVfllOfi- 

If you havfl a ciBset-tfl-bassd version f ycxj may e^ichange it for tfie 
diskette version, T+ie disltette-based version supports Assembly and 
load module filts on diskette as opposed to the cassette -Baaed version 
which will only support ci^eelte files. 

The cMtended-feature version requires a4 lea^t 6^ to run ^minimum 
ejipaf^MQT mf mory ol SKP. Ita main benefits ire the ability to switch 
rapidly between Editor and Assembler modea without having to save the 
Aflsemhly progran then lead the AaaembLer which th&n Will have to ne- 
ISAd \h' Assembly program. The Editor and Assemhler are combined into 
one program. The other feature provided with the en tsnded -feature 
versiofi is ihe ability \a direftly POKE the machine languagp output 
from the Assembler into the VIC'^ memory without having to save it as 
a Load module for input by the Loader, The POKE option is added to 
and clMS rol replace -the SAVE te iture d-F the standard versian. 

Ttie cost of the frKtended-feature upgrade is llft.eS. RS-r32 Printer 
Buport i^ available with the e^itended-feattre versiun for an 
additional W.M. The diaK versi^on upgrade ia 15,8*, All feature 
option prices are additive. So disk and extended features and RE-232 
ia fZiM, 



To receive the upgrades- you need arJy ffltjpn the original cacaette or 
diskette along with your check or money order (U.S. Funds) or VISA/MC 
num ti«r / e >[p]ratiDn d ate . 

Send the miagnetit media and the payment to: 

P"n#nc»-i Silk 

P.O. HOX 287 
Cannon Palls, HM5S«4f 



If you da not wish to take advantage of the enchangp offer but would 
liKe to be oti the mailing list for future productst send us ydur rume 
ard address. Ue will be happy to include you in our future m^Lings. 



